LangBot Space MCP Operations
LangBot Space (space.langbot.app) exposes an MCP server so user-facing AI agents can browse and search the marketplaces (plugins, MCP servers, skills) and rank live models for automated setup.
Endpoint
https://space.langbot.app/mcp
Transport: streamable HTTP (stateless, JSON responses). For a self-hosted
Space instance: http://<host>:8383/mcp.
Authentication
Reuses the existing Personal Access Token (PAT) — the same token the lbp
CLI uses. Create one in your Space account (Profile → Personal Access Tokens),
then send it as a Bearer token:
Authorization: Bearer lbpat_...uests without a valid PAT get `401 Unauthorized`.
## Client configuration
```json
{
"mcpServers": {
"langbot-space": {
"url": "https://space.langbot.app/mcp",
"headers": { "Authorization": "Bearer <your-pat>" }
}
}
}
Tool surface
| Tool | Purpose |
|---|---|
list_plugins / search_plugins / get_plugin |
Plugin marketplace |
list_mcp_servers / search_mcp_servers / get_mcp_server |
MCP-server marketplace |
list_skills / search_skills / get_skill |
Skill marketplace |
select_models |
Live best-first model list for setup wizards; optional category filter |
list_* and search_* are paged (page, page_size). get_* takes
author + name. The tool surface mirrors the REST endpoints under
/api/v1/marketplace/*; select_models mirrors /api/v1/models/selection.
All tools are read-only.
How to use
- Create a PAT in your Space account settings.
- Point your MCP client at
https://space.langbot.app/mcpwith the Bearer PAT. - Use
search_plugins/search_mcp_servers/search_skillsto find items, thenget_*for details (e.g. to obtain author/name for installation in LangBot itself). - For automatic local-agent setup, call
select_models(optionally withcategory) and choose the first compatible item. Ordering is latest probe state (available, unprobed, unavailable), then Space recommendation. Each item includesavailability.up,last_probed_at, latency, and HTTP status.
Implementation & maintenance (for Space developers)
- Server:
internal/controller/mcp/server.go(official Go MCP SDKgithub.com/modelcontextprotocol/go-sdk). Tools call the service layer (PluginService,MCPService,SkillService,ModelStatusService) directly. - Mount:
internal/controller/api.goat/mcpand/mcp/*any. - Auth: PAT via
AccountService.ValidatePersonalAccessToken. - Docs:
docs/MCP_SERVER.md.
When you add, remove, or change a marketplace API endpoint that should be agent-accessible, update the corresponding MCP tool and this skill. The MCP tool surface and the API must stay aligned (see
AGENTS.md).
Pitfalls
- The PAT prefix is
lbpat_(Space), distinct from LangBot'slbk_API keys. - This server is read/browse only; it does not publish or modify marketplace items. Use the web UI or REST API (with appropriate auth) for that.