Hosted User Spaces

Declare agent-compatible context for users on GitHub, Notion, and more

Many platforms host content at URLs like github.com/user or notion.so/workspace, where individuals can't control /.well-known. The MCP spec supports platform-declared user proxies.

๐Ÿ“ฆ Platform Example: GitHub

{
  "feed_type": "mcp",
  "user_spaces": [
    {
      "pattern": "https://github.com/*",
      "mcp_proxy": "https://api.github.com/mcp/user/{username}",
      "trust_default": "public",
      "profile_fields": ["bio", "website"]
    }
  ]
}

Agents first look for user/.well-known/mcp, then fallback to github.com/.well-known/mcpwhich can redirect via user_spaces.

๐ŸŒ This enables portable agent behavior even on platforms without static file hosting.