Skip to main content

Repositories

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READscrape-creators.scrape_creators_github_get_v1_github_user_repositories
  • Contract tier: legacy
  • Risk: read
  • Catalog version: scrape-creators-2026.07.12.1
  • Descriptor hash: 86fdb884f3f3997f7dfce29b0b0a4533b033afafb4092027e73ec60392e9644a

Use this when you need ScrapeCreators GitHub data from GET /v1/github/user/repositories for Repositories. Retrieves a user's public repositories with repo metadata like description, language, stars, forks, topics, license, visibility, default branch, and timestamps. Pass username, handle, or url. Supports pagination with cursor, plus GitHub's type, sort, and direction parameters. Returns the ScrapeCreators response in the standard MCP envelope with ok/data/error/meta. This is read-only. Requires the portal grant header and a ScrapeCreators BYOK API key.

Request Body​

{
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-github-get-v1-github-user-repositories-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_github_get_v1_github_user_repositories",
    "arguments": {
      "url": "",
      "body": "",
      "sort": "created",
      "type": "owner",
      "cursor": "",
      "handle": "",
      "params": "",
      "compact": "",
      "username": "",
      "direction": "asc"
    }
  }
}

Arguments Schema​

{
  "type": "object",
  "properties": {
    "url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Url",
      "default": null,
      "description": "GitHub user URL, e.g. https://github.com/kentcdodds."
    },
    "body": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "null"
        }
      ],
      "title": "Body",
      "default": null,
      "description": "JSON request body for provider endpoints that accept one."
    },
    "sort": {
      "enum": [
        "created",
        "updated",
        "pushed",
        "full_name"
      ],
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sort",
      "default": null,
      "description": "Sort by created, updated, pushed, or full_name. Defaults to updated."
    },
    "type": {
      "enum": [
        "owner",
        "all",
        "member"
      ],
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Type",
      "default": null,
      "description": "Repository type. Defaults to owner. GitHub also supports all and member."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "default": null,
      "description": "Cursor from the previous response. Defaults to 1."
    },
    "handle": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Handle",
      "default": null,
      "description": "GitHub username/handle of the user you want the repositories for"
    },
    "params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Params",
      "default": null,
      "description": "Optional advanced query parameter object. Prefer the documented top-level parameters when available."
    },
    "compact": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Compact",
      "default": null,
      "description": "When true, trims large list payloads before returning them to the agent."
    },
    "username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Username",
      "default": null,
      "description": "Alias for handle: GitHub username/handle of the user you want the repositories for"
    },
    "direction": {
      "enum": [
        "asc",
        "desc"
      ],
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Direction",
      "default": null,
      "description": "Sort direction: ascending or descending."
    },
    "max_items": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Items",
      "default": null,
      "description": "Maximum number of list items to return when compacting provider responses."
    },
    "include_raw": {
      "type": "boolean",
      "title": "Include Raw",
      "default": false,
      "description": "When true, returns both compact normalized data and the raw provider payload; this can be large."
    },
    "path_params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Path Params",
      "default": null,
      "description": "Path template values for endpoints that expose path placeholders."
    },
    "cache_ttl_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cache Ttl Seconds",
      "default": null,
      "description": "Optional cache lifetime for idempotent GET requests."
    },
    "confirm_high_cost": {
      "type": "boolean",
      "title": "Confirm High Cost",
      "default": false,
      "description": "Set true only when intentionally running a high-credit or write-intent request."
    }
  },
  "additionalProperties": false
}

Output Schema​

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded operation result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe request, pagination, cache, and timing metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Scrape Creators MCP normalized response envelope.",
  "additionalProperties": false
}

Code Examples​

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-github-get-v1-github-user-repositories-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_github_get_v1_github_user_repositories",
    "arguments": {
      "url": "",
      "body": "",
      "sort": "created",
      "type": "owner",
      "cursor": "",
      "handle": "",
      "params": "",
      "compact": "",
      "username": "",
      "direction": "asc"
    }
  }
}'

Example Responses​

{
  "ok": true,
  "message": "Tool scrape-creators.scrape_creators_github_get_v1_github_user_repositories executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}