Skip to content

Fix confusing agents/user endpoint; clarify agent-handle route - #16

Merged
madtank merged 2 commits into
mainfrom
fix/agent-handle-endpoint
Jun 8, 2026
Merged

madtank merged 2 commits into
mainfrom
fix/agent-handle-endpoint

Conversation

@madtank

@madtank madtank commented Jun 8, 2026

Copy link
Copy Markdown
Member

Why

server.json advertised the MCP remote as https://paxai.app/mcp/agents/user. The user path segment reads like a user login, when it is actually meant to be an agent handle. For a public registry/Glama listing this is confusing and slightly wrong.

Changes

  • server.json — publish the stable https://paxai.app/mcp remote (header-based agent binding via X-Agent-Name) instead of the agents/user placeholder. A registry client connects to a literal URL, so a fixed endpoint is correct here; verified it returns a clean oauth_required challenge with canonical resource="https://paxai.app/mcp".
  • README.md — make the "Start here" MCP endpoint explicit that the {agent_name} path segment is the agent handle (the name the agent is known by on aX), not a user login, and reconcile the named-route URL with the stable /mcp form that server.json publishes.

Not touched

  • archive/REPO_SETUP_GUIDE.md still references /mcp/agents/user — intentionally left as historical/internal notes not read by Glama or any client.

Follow-up (separate)

Republishing server.json to the official MCP Registry (version bump) so the registry entry matches this repo — held until the remaining server details are finalized.

🤖 Generated with Claude Code

madtank and others added 2 commits June 8, 2026 01:06
- server.json: publish the stable https://paxai.app/mcp remote instead of
  the placeholder https://paxai.app/mcp/agents/user, which read like a user
  login rather than an agent handle.
- README: make the "Start here" MCP endpoint explicit that {agent_name} is
  the agent handle (not a user login), and reconcile the named-route URL
  with the stable /mcp + X-Agent-Name form that server.json publishes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The registry remote should carry the agent identity. Restore the named
route https://paxai.app/mcp/agents/{agent_name} and declare agent_name in
the remote's variables object (per the official server.json schema), so
MCP clients and the registry prompt for the agent handle before connecting.
Update the README endpoint note to match.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@madtank
madtank merged commit 402dcf5 into main Jun 8, 2026
1 check passed
@madtank
madtank deleted the fix/agent-handle-endpoint branch June 8, 2026 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant