AI and integrations

MCP server

Connect AI clients to your organization's knowledge, agents and connectors over the Model Context Protocol.

Endpoint

https://mcp.dev.superintelligence.gov.vin/mcp

The server speaks the Streamable HTTP transport, statelessly: each request is handled on its own, with no session, and answered with a JSON response rather than an event stream. It's the programmatic interface for organizations.

Authenticate

Send an MCP key as a bearer token:

Authorization: Bearer si_mcp_…

Owners and admins create MCP keys at https://id.dev.gov.vin → organization → Keys, type MCP client (Keys). The key's scopes decide which tools the server offers. Without a valid key (missing, unknown, revoked, expired or not an MCP key) the server answers 401 with WWW-Authenticate: Bearer realm="mcp" and a JSON-RPC error.

Signing in MCP clients with your account instead of a key is planned. Coming soon

Connect a client

claude mcp add --transport http si https://mcp.dev.superintelligence.gov.vin/mcp --header "Authorization: Bearer $SI_MCP_KEY"

For clients configured with an mcpServers file, such as .mcp.json:

.mcp.json

{
  "mcpServers": {
    "si": {
      "type": "http",
      "url": "https://mcp.dev.superintelligence.gov.vin/mcp",
      "headers": { "Authorization": "Bearer ${SI_MCP_KEY}" }
    }
  }
}

curl -s https://mcp.dev.superintelligence.gov.vin/mcp \
  -H "Authorization: Bearer $SI_MCP_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

Every key gets whoami; the others need the scope shown. Arguments and details are on MCP tools.

Tool	Scope	Description
`whoami`	none	Identity and scopes of the current key.
`context_get`	`knowledge:read`	Read a context entry by namespace and key.
`context_list`	`knowledge:read`	List context entries in a namespace, optionally filtered by key prefix.
`pages_list`	`knowledge:read`	List knowledge base pages under a parent (default: top level).
`page_get`	`knowledge:read`	Read a knowledge base page as Markdown with front matter (title, version, ...).
`page_search`	`knowledge:read`	Search knowledge base pages by title and text.
`context_put`	`knowledge:write`	Create or replace a context entry.
`context_delete`	`knowledge:write`	Delete a context entry.
`page_upsert`	`knowledge:write`	Create a knowledge base page from Markdown, or replace an existing page's content.
`agent_job_create`	`agents:run`	Queue work for one of the organization's self-hosted agents.
`agent_job_get`	`agents:read`	Status of an agent job, with a temporary results URL once done.
`connectors_list`	`connectors:read`	Remote MCP servers connected to this organization and the tool names they add here.

Keys with connectors:read also get the tools of the organization's enabled connectors, named <slug>__<tool>.

Activity

Tools that change data (context_put, context_delete, page_upsert, agent_job_create) are recorded in the audit log with the key as the actor. Requests time out after 60 seconds.