MCP Server

Qosm exposes an MCP server that lets you use Qosm tools from any MCP-compatible client — including Claude Desktop, Cursor, and custom agents.

Available tools

| Tool | Description | |------|-------------| | get_projects | List your Qosm projects | | get_project_context | Get a project's code, capabilities, and settings | | get_project_functions | List functions in a project with their types | | qosm_check | Typecheck Qosm code | | qosm_run | Execute a published agent | | qosm_call_function | Call a specific function with arguments |

Connecting from Claude Desktop

Add the Qosm MCP server to your Claude Desktop configuration:

{
  "mcpServers": {
    "qosm": {
      "url": "https://your-qosm-host.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with your personal access token.

Connecting from Cursor

In Cursor settings, add the MCP server URL under the MCP configuration section with your authentication token.

Authentication

All MCP requests require a personal access token sent as a Bearer token in the Authorization header.

Using with Claude

Once connected, Claude can:

• Browse your Qosm projects
• Read and understand your agent code
• Typecheck code changes before applying them
• Call your published agent functions directly
• Help you debug type errors using the Qosm typechecker

Example conversation:

"List my Qosm projects and show me the functions in my sentiment-analyzer project"

Claude will use the get_projects and get_project_functions tools to answer.