Connect a-gntto Claude, ChatGPT & Grok

The /api/mcp endpoint implements Anthropic’s Model Context Protocol over HTTP+SSE. It advertises a catalog of tools mapped to the user’s saved prompts, souls, skills, and benches. Every request is authenticated, so one user’s library never leaks to another’s client.

The /.well-known/openapi.json endpoint exposes the same operations as an OpenAPI 3.1 spec so ChatGPT custom GPT Actions (which don’t speak MCP) can call them. Both endpoints share the same OAuth flow and read from the same underlying records.

Both endpoints authenticate via OAuth 2.0 (Authorization Code flow with PKCE). Clients get redirected to https://a-gnt.com/api/oauth/authorize, the user signs in with their a-gnt account, and the client receives an opaque bearer token to include on every request.

authorize_url

https://a-gnt.com/api/oauth/authorize

token_url

https://a-gnt.com/api/oauth/token

scopes

library:read benches:read tools:call

grant_type

authorization_code

pkce

S256 required

Tokens are scoped to the authorizing user and can be revoked at any time from /profile.

Works in Claude Desktop, Claude Web, and Claude Mobile on Pro, Team, or Enterprise plans.

1. 1

   Step 1

   Open Claude Settings → Connectors

   In Claude Desktop or the web app, click your name in the bottom-left → Settings → Connectors. On mobile, tap your avatar → Settings → Connectors.
2. 2

   Step 2

   Add a custom connector

   Click 'Add custom connector' (sometimes shown as 'Browse' → 'Add your own'). You'll get a form asking for a name and a URL.
3. 3

   Step 3

   Name it 'a-gnt' and paste the connector URL

   Name: a-gnt. URL: https://a-gnt.com/api/mcp. Leave the authentication method on 'OAuth' if Claude asks.

   Connector URL

   https://a-gnt.com/api/mcpCopy
4. 4

   Step 4

   Sign in

   Claude will open an a-gnt login window. Sign in with the same account you use on a-gnt.com. Claude now sees your library, your benches, and your saved prompts.
5. 5

   Step 5

   Try it

   Start a new Claude chat and type: 'Use my Sunday Reset bench.' Claude will fetch the bench and respond in character.

ChatGPT exposes our endpoints through the custom GPT Actions surface. Requires a ChatGPT Plus account to build; any ChatGPT user can then use the saved GPT.

You are a concierge for my a-gnt library. When I ask for a bench, prompt, or tool by name, call the a-gnt action to fetch it and respond in character. If I don't specify one, ask which bench I want to use.

1. 1

   Step 1

   Open ChatGPT → Explore GPTs → Create

   In the ChatGPT sidebar, click 'Explore GPTs' → 'Create' in the top right. This opens the GPT builder.
2. 2

   Step 2

   Click 'Configure'

   The chat builder is slow. Click the 'Configure' tab at the top for direct field access.
3. 3

   Step 3

   Fill in the basics

   Name: a-gnt. Description: My personal AI library. Paste the instructions block from this page into the Instructions field.

   Instructions

   You are a concierge for my a-gnt library. When I ask for a bench, prompt, or tool by name, call the a-gnt action to fetch it and respond in character. If I don't specify one, ask which bench I want to use.

   Copy
4. 4

   Step 4

   Add the a-gnt Action

   Scroll to 'Actions' → 'Create new action'. In the Schema box, paste https://a-gnt.com/.well-known/openapi.json. Authentication: OAuth. Sign in with your a-gnt account.

   Schema URL

   https://a-gnt.com/.well-known/openapi.jsonCopy
5. 5

   Step 5

   Save as Private

   Click 'Save' → 'Only me'. This keeps your GPT and your library access scoped to your account.
6. 6

   Step 6

   Use it

   Open the a-gnt GPT from your sidebar and say: 'Use my Sunday Reset bench.' ChatGPT will call the action and respond in character.

Grok (xAI) supports MCP servers as of Grok 4. Any MCP-compliant endpoint can be added from Settings → Tools → MCP servers. Since Grok’s app UI iterates frequently, confirm the menu location against xAI’s current docs if the label moves.

1. 1

   Step 1

   Open Grok Settings → Tools → MCP servers

   In the Grok app (grok.com or the iOS/Android app), open Settings → Tools → MCP servers. On desktop the panel may also appear under the 'Connections' heading. Exact label can vary between Grok versions.
2. 2

   Step 2

   Add a new MCP server

   Click 'Add MCP server' (sometimes 'Connect MCP' or 'New connection'). Grok will ask for a name and a URL.
3. 3

   Step 3

   Name it 'a-gnt' and paste the MCP URL

   Name: a-gnt. URL: https://a-gnt.com/api/mcp. If Grok offers a transport option, pick HTTP+SSE. Leave authentication on OAuth.

   URL

   https://a-gnt.com/api/mcpCopy
4. 4

   Step 4

   Sign in

   Grok will open an a-gnt login window. Sign in with the same account you use on a-gnt.com. Grok now has access to your library, benches, and saved prompts.
5. 5

   Step 5

   Use it

   Start a new Grok chat and type: 'Use my Sunday Reset bench.' Grok will fetch the bench via MCP and respond in character.

For Claude Code, Cursor, VS Code Copilot, Windsurf, and Zed, drop this block into your client’s MCP config file and restart the client. No chat UI involved.

{
  "mcpServers": {
    "a-gnt": {
      "url": "https://a-gnt.com/api/mcp"
    }
  }
}

All operations live under the common endpoint tree. Both MCP and OpenAPI bindings call the same underlying handlers.

GET /api/mcp

MCP SSE transport endpoint

GET /api/v1/tools

list approved tools (filter: type, category)

GET /api/v1/tools/:slug

fetch a single tool's metadata + content

GET /api/v1/benches

list the authenticated user's benches

GET /api/v1/benches/:id

fetch a bench with its items

GET /api/library/count

summary counts of the user's library

Rate limit

120 requests / minute per token

The full OpenAPI spec is published at https://a-gnt.com/.well-known/openapi.json.

Clients should treat 4xx as permanent (until the user re-auths) and 5xx as transient.

401

missing or expired token — re-run OAuth flow

403

valid token but scope missing the required permission

404

tool or bench not found in this user's library

429

rate limit hit — back off per Retry-After header

500

unexpected server error — report at /feedback

Q

What's the a-gnt MCP URL I should paste into Claude?

A

Use https://a-gnt.com/api/mcp as the connector URL in Claude's custom connector settings. No trailing slash. Leave authentication on OAuth.

Q

What's the OpenAPI schema URL for a ChatGPT custom GPT?

A

Use https://a-gnt.com/.well-known/openapi.json. In the ChatGPT GPT builder, go to Configure → Actions → Create new action, and paste the URL into the Schema box's 'Import from URL' field.

Q

Does this work on the free Claude plan?

A

Claude custom connectors require a paid Claude plan (Pro, Team, or Enterprise). If you're on Claude Free, you can still copy-paste prompts from a-gnt.com manually, or use the ChatGPT custom GPT path which works with any ChatGPT Plus account.

Q

Is my a-gnt library private when I connect it?

A

Yes. Both the MCP connector and the OpenAPI action require OAuth sign-in with your a-gnt account, and only return tools and benches you've saved. Your library never becomes public unless you explicitly share a bench.

Q

How do I connect a-gnt inside Cursor or VS Code?

A

Drop this config into your editor's MCP client config file: { "mcpServers": { "a-gnt": { "url": "https://a-gnt.com/api/mcp" } } }. Claude Code, Cursor, Windsurf, and Zed all read this format.

Q

Can I connect a-gnt to Grok (xAI)?

A

Yes. Grok supports MCP servers as of Grok 4. Open Grok → Settings → Tools → MCP servers → Add MCP server, name it 'a-gnt', and paste https://a-gnt.com/api/mcp as the URL. Authenticate with OAuth when Grok prompts you. The exact menu label can shift between Grok versions — check xAI's current docs if you don't see it.