{"id":38279702,"url":"https://github.com/accelbyte/ags-extend-sdk-mcp-server","last_synced_at":"2026-06-03T07:01:28.198Z","repository":{"id":322381127,"uuid":"1080387075","full_name":"AccelByte/ags-extend-sdk-mcp-server","owner":"AccelByte","description":"An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively","archived":false,"fork":false,"pushed_at":"2026-05-26T08:49:16.000Z","size":6493,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-26T10:28:07.467Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AccelByte.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-21T09:47:20.000Z","updated_at":"2026-05-26T08:49:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AccelByte/ags-extend-sdk-mcp-server","commit_stats":null,"previous_names":["accelbyte/ags-extend-sdk-mcp-server"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/AccelByte/ags-extend-sdk-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AccelByte%2Fags-extend-sdk-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AccelByte%2Fags-extend-sdk-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AccelByte%2Fags-extend-sdk-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AccelByte%2Fags-extend-sdk-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AccelByte","download_url":"https://codeload.github.com/AccelByte/ags-extend-sdk-mcp-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AccelByte%2Fags-extend-sdk-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33852295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T01:56:33.828Z","updated_at":"2026-06-03T07:01:28.192Z","avatar_url":"https://github.com/AccelByte.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AGS Extend SDK MCP Server\n\nA Model Context Protocol (MCP) server that gives AI assistants (VS Code Copilot, Cursor, Claude, Gemini, Antigravity) the AccelByte Extend SDK as additional context — so they can answer questions about the SDK and generate correct Extend SDK code.\n\n## What It Does\n\n- **Search** Extend SDK symbols (functions and models) by name, tags, or description (fuzzy matching)\n- **Describe** specific symbols — parameters, fields, imports, examples, return types, required permissions\n- **Scaffold** a new Extend app from a template repository via the `create-extend-app` prompt\n\nIt serves SDK reference for **four languages — C#, Go, Java, and Python**. You pick the language per connection through the URL path (see [Choose your language](#step-1-choose-your-language-and-get-your-url)).\n\nAccelByte hosts the Extend SDK MCP Server for you — **you don't need to install or run anything locally**. Just point your AI assistant at the hosted MCP URL for your language. There's **no sign-in**: the server only exposes read-only SDK reference data. Prefer to run it yourself? See [Running Locally \u0026 Self-Hosting](docs/LOCAL.md).\n\n---\n\n## Quick Install\n\nPaste this into your AI coding assistant — it will fetch the install guide, ask you a couple of questions, and configure everything for you:\n\n```\nInstall the AGS Extend SDK MCP server for me. Fetch and follow the instructions at\nhttps://raw.githubusercontent.com/AccelByte/ags-extend-sdk-mcp-server/refs/heads/master/INSTALL.md\n```\n\nWorks in **VS Code Copilot**, **Cursor**, **Claude Code**, **Antigravity**, and **Gemini CLI**.\n\n\u003e **Claude Desktop users:** The simplest path is **Settings → Connectors → Add custom connector** (Name: `extend-sdk`, URL: your MCP URL) — no AI installer needed. See [Claude Desktop](#claude-desktop) below.\n\u003e\n\u003e If you want to use the Quick Install prompt above, switch to the **Code** tab first (Chat and Cowork can't edit your config file).\n\u003e\n\u003e ![Claude Desktop — Code tab](docs/images/claude-desktop-code.png)\n\nPrefer to do it yourself? See [Manual Install](#manual-install) below.\n\n---\n\n## Manual Install\n\n### Step 1: Choose your language and get your URL\n\nThe MCP URL is the hosted server's base URL followed by `/extend-mcp/{language}`:\n\n```\nhttps://\u003cmcp-server-host\u003e/extend-mcp/{language}\n```\n\n| Language | URL path |\n|---|---|\n| C# | `/extend-mcp/csharp` |\n| Go | `/extend-mcp/go` |\n| Java | `/extend-mcp/java` |\n| Python | `/extend-mcp/python` |\n\n- `\u003cmcp-server-host\u003e` is the host of your organization's deployment — ask your AccelByte administrator if you're not sure.\n- One hosted instance serves every language. To switch language later, just change the trailing path segment (e.g. `/extend-mcp/python` → `/extend-mcp/go`). Requesting an unknown language returns HTTP `400`.\n- The base path (`/extend-mcp`) with no language serves the server's configured default language.\n\n\u003e **No hosted instance?** You can run the server yourself with Docker — see [Running Locally \u0026 Self-Hosting](docs/LOCAL.md).\n\n### Step 2: Configure your client\n\nThe server uses **Streamable HTTP** transport. Clients that support HTTP transport connect to the URL directly. Clients that only support **stdio** transport use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) as a bridge.\n\n\u003e **Need `mcp-remote`?** It runs via `npx`, so you need **Node.js 18+ with `npx` available** — verify with `npx --version`. No global install required.\n\nSubstitute your URL from Step 1 wherever you see `\u003cURL\u003e` below.\n\n#### Visual Studio Code (Copilot)\n\n`.vscode/mcp.json` in your workspace (or user `settings.json`):\n\n```json\n{\n  \"servers\": {\n    \"extend-sdk\": {\n      \"type\": \"http\",\n      \"url\": \"\u003cURL\u003e\"\n    }\n  }\n}\n```\n\nIf your client can't reach an HTTP server, swap to: `{ \"command\": \"npx\", \"args\": [\"-y\", \"mcp-remote\", \"\u003cURL\u003e\"] }`.\n\nSee the [VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).\n\n#### Cursor\n\n`.cursor/mcp.json` in your workspace (or user settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"extend-sdk\": {\n      \"type\": \"http\",\n      \"url\": \"\u003cURL\u003e\"\n    }\n  }\n}\n```\n\nIf your client can't reach an HTTP server, swap to: `{ \"command\": \"npx\", \"args\": [\"-y\", \"mcp-remote\", \"\u003cURL\u003e\"] }`.\n\nSee the [Cursor MCP documentation](https://cursor.com/docs/context/mcp#using-mcpjson).\n\n#### Claude Code\n\n```bash\nclaude mcp add --transport http extend-sdk \u003cURL\u003e\n```\n\nFallback (stdio-only environments): `claude mcp add extend-sdk -- npx -y mcp-remote \u003cURL\u003e`.\n\nSee the [Claude Code MCP documentation](https://code.claude.com/docs/en/mcp#installing-mcp-servers).\n\n#### Antigravity\n\n`mcp_config.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"extend-sdk\": {\n      \"type\": \"http\",\n      \"url\": \"\u003cURL\u003e\"\n    }\n  }\n}\n```\n\nIf your client can't reach an HTTP server, swap to: `{ \"command\": \"npx\", \"args\": [\"-y\", \"mcp-remote\", \"\u003cURL\u003e\"] }`.\n\nSee the [Antigravity MCP documentation](https://antigravity.google/docs/mcp#connecting-custom-mcp-servers).\n\n#### Gemini CLI\n\n```bash\ngemini mcp add --transport http extend-sdk \u003cURL\u003e\n```\n\nFallback (stdio-only environments): `gemini mcp add extend-sdk -- npx -y mcp-remote \u003cURL\u003e`.\n\nSee the [Gemini CLI MCP documentation](https://geminicli.com/docs/tools/mcp-server/#configure-the-mcp-server-in-settingsjson).\n\n#### Claude Desktop\n\n**Option A — Custom Connector (recommended)**\n\n1. Open **Settings → Connectors → Add custom connector** (under the \"Customize\" area).\n2. Fill in **Name**: `extend-sdk` and **Remote MCP server URL**: your `\u003cURL\u003e` from Step 1.\n3. Save.\n\n\u003e **Don't see \"Add custom connector\"?** Some Team and Enterprise plans disable custom connectors via workspace policy. If the option is missing or greyed out, use Option B.\n\n**Option B — `mcp-remote` config file (fallback)**\n\nEdit `claude_desktop_config.json`:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"extend-sdk\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"\u003cURL\u003e\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n---\n\n## Using the Tools\n\nOnce connected, your assistant has access to these tools. In your assistant's chat, try the example prompts below — give permission to run the tools when requested.\n\n### `search-symbols`\n\nSearch Extend SDK symbols by name, tags, or description, with fuzzy matching. Returns a paginated list of summaries.\n\n\u003e *\"Search for symbols related to user\"* · *\"Find symbols for inventory\"*\n\n### `describe-symbols`\n\nGet full details for specific symbols by ID — fields, parameters, imports, example usage, return type, and required permissions.\n\n\u003e *\"Describe the `AdminCreateUser@iam` and `User@iam` symbols\"*\n\n### `create-extend-app`\n\nA prompt template that clones an Extend app template repository and opens it (in a Dev Container when available) so you can start from a working sample.\n\n\u003e Invoke the `create-extend-app` prompt and follow the scenario / template / language completions.\n\n\u003e [!TIP]\n\u003e When coding with this MCP server, start from an Extend SDK getting-started sample or an Extend app template instead of a blank project, and add relevant source files as context for better results.\n\n---\n\n## Running it yourself\n\nPrefer to run the server locally (stdio) or host the HTTP server yourself? See **[Running Locally \u0026 Self-Hosting](docs/LOCAL.md)** for Docker usage, environment variables, HTTP endpoints, developing from source, and releasing the image.\n\n---\n\n## Troubleshooting\n\n### Tool calls fail / the server returns `400`\n\nCheck the language in your URL path. It must be one of `csharp`, `go`, `java`, or `python` (e.g. `/extend-mcp/go`). An unknown language returns HTTP `400`.\n\n### Client can't connect to the HTTP URL\n\nSome clients only support stdio transport. Switch that client to the `mcp-remote` bridge config shown in [Step 2](#step-2-configure-your-client). It needs Node.js 18+ with `npx` available (`npx --version`).\n\n### \"Connection refused\" or the host is unreachable\n\nConfirm the `\u003cmcp-server-host\u003e` and full URL are correct (ask your AccelByte administrator), and that your network can reach it.\n\n---\n\n## Documentation\n\n- [Installation Guide](INSTALL.md) — followed by the Quick Install prompt; readable on its own\n- [Running Locally \u0026 Self-Hosting](docs/LOCAL.md) — Docker, environment variables, HTTP endpoints, development, and releasing the image\n\n## Contributions\n\nThis repository is published as-is. For bug reports and questions, please open an issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faccelbyte%2Fags-extend-sdk-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faccelbyte%2Fags-extend-sdk-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faccelbyte%2Fags-extend-sdk-mcp-server/lists"}