01.software MCP Server
======================

MCP server for AI agents to interact with the 01.software API.
Connect over HTTP with OAuth, or use the local CLI stdio transport for full
server-key operations.


Authentication
--------------

HTTP MCP uses OAuth discovery and Authorization Code + PKCE.
Clients should connect to:

Connect
-------

Claude Code:

  claude mcp add --transport http 01software https://mcp.01.software/mcp

Codex (.codex/config.toml):

  [mcp_servers.01software]
  url = "https://mcp.01.software/mcp"

Cursor / Claude Desktop / other JSON clients:

  {
    "mcpServers": {
      "01software": {
        "type": "http",
        "url": "https://mcp.01.software/mcp"
      }
    }
  }

Windsurf (~/.codeium/windsurf/mcp_config.json):

  {
    "mcpServers": {
      "01software": {
        "serverUrl": "https://mcp.01.software/mcp"
      }
    }
  }

CLI (stdio):

  npx @01.software/cli mcp


HTTP OAuth Tools
----------------

Schema       get-collection-schema
Context      get-tenant-context
Field Config list-configurable-fields, update-field-config
Guidance     sdk-get-recipe, sdk-search-docs, sdk-get-auth-setup, sdk-get-collection-pattern

Full Tool Surface
-----------------

The local CLI stdio transport exposes CRUD, commerce, cart, validation, product,
schema, context, field-config, and guidance tools:

  npx @01.software/cli mcp

Prompts (4): sdk-usage-guide, collection-query-help, order-flow-guide, feature-setup-guide
Resources (12): config, collections-schema, getting-started, guides, api, query-builder, react-query, server-api, customer-auth, browser-vs-server, file-upload, webhook


Links
-----

Docs            https://01.software/docs/integrations/mcp
SDK             https://01.software/docs/sdk/client
API Reference   https://01.software/docs/api/rest-api
Console         https://console.01.software