developers

Docs AI & MCP Install & connect

Install & connect

The Merchant MCP runs locally over stdio. Point your agent at it and sign in.

Get the server

The Merchant MCP is @mecsto/mcp, in its own repository. It is currently shared per partner — ask Mecsto for access, then clone it and install:

bash
git clone https://github.com/naveen-mec/mecsto-mcp.git
cd mecsto-mcp && npm install

Configure your client

Add an entry to your MCP client config — .mcp.json for Claude Code, the equivalent for other clients:

.mcp.json
{
  "mcpServers": {
    "mecsto": {
      "command": "node",
      "args": ["/path/to/mecsto-mcp/src/index.js"],
      "env": {}
    }
  }
}

Leave env empty to start. The server runs read-only until you deliberately add a gate.

Sign in

Two tools, in order. Ask your agent to call them.

text
login        { "email": "you@yourbusiness.com" }
             → a 8-digit code arrives in your inbox

verify_login { "email": "you@yourbusiness.com", "code": "12345678" }
             → session stored locally, 0600

Then whoami confirms who you are, which store the connection operates on, your role, and whether publishing is enabled.

The session file is a credential. It is written 0600 in your home directory and is a live merchant session. Treat it like an SSH key. logout revokes it server-side, not just locally.