Client configuration

The server uses the official Streamable HTTP transport, so any MCP 2025-06-18 client works. All examples use the same endpoint and header:

• URL: https://www.skavio.eu/processing/mcp
• Header: Authorization: Bearer <MCP credential>

Replace skavio_mcp_REPLACE_WITH_YOUR_CREDENTIAL in every example.

Generic JSON (many clients)

{
  "mcpServers": {
    "skavio": {
      "url": "https://www.skavio.eu/processing/mcp",
      "headers": {
        "Authorization": "Bearer skavio_mcp_REPLACE_WITH_YOUR_CREDENTIAL"
      }
    }
  }
}

Claude Desktop / Claude Code (claude_desktop_config.json / .mcp.json)

{
  "mcpServers": {
    "skavio": {
      "type": "http",
      "url": "https://www.skavio.eu/processing/mcp",
      "headers": {
        "Authorization": "Bearer skavio_mcp_REPLACE_WITH_YOUR_CREDENTIAL"
      }
    }
  }
}

VS Code / Cline / Continue (mcp.json)

{
  "servers": {
    "skavio": {
      "type": "http",
      "url": "https://www.skavio.eu/processing/mcp",
      "headers": {
        "Authorization": "Bearer skavio_mcp_REPLACE_WITH_YOUR_CREDENTIAL"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "skavio": {
      "url": "https://www.skavio.eu/processing/mcp",
      "headers": {
        "Authorization": "Bearer skavio_mcp_REPLACE_WITH_YOUR_CREDENTIAL"
      }
    }
  }
}

Programmatic client (official Python SDK)

import asyncio

from mcp import ClientSession
from mcp.client.streamable_http import (
    create_mcp_http_client,
    streamable_http_client,
)

BASE = "https://www.skavio.eu/processing/mcp"


async def main(credential: str):
    headers = {"Authorization": f"Bearer {credential}"}
    async with (
        create_mcp_http_client(headers=headers, timeout=30) as http,
        streamable_http_client(BASE, http_client=http) as (read, write, _),
        ClientSession(read, write) as session,
    ):
        await session.initialize()
        tools = await session.list_tools()
        print([t.name for t in tools.tools])
        catalog = await session.call_tool("skavio_paid_catalog", {})
        print(catalog.structuredContent)


asyncio.run(main("skavio_mcp_REPLACE_WITH_YOUR_CREDENTIAL"))

Local stdio mode (no remote credential)

For local experiments the same code runs over stdio against the live API with your own API key, or against explicit synthetic mode for tests:

{
  "mcpServers": {
    "skavio": {
      "command": "python",
      "args": [
        "-m",
        "skavio_mcp.server",
        "--mode",
        "live",
        "--state-dir",
        ".skavio-mcp"
      ]
    }
  }
}

Set SKAVIO_API_KEY and SKAVIO_COMPANY_ID in the client's environment. Stdio mode keeps paid work disabled unless an operator enables it with reviewed cost evidence; the remote Streamable HTTP server is the supported paid path.

Verify the connection

1. skavio_capabilities should succeed and list operations.
2. skavio_wallet should show your company balance.
3. A wrong or missing credential returns 401.

See troubleshooting if a call fails.