What is the Tirdad MCP server?
- An MCP server that exposes your Tirdad API as MCP tools so AI assistants can call your API without reading REST docs.
- Runs on your machine with npx and connects to the Tirdad API with your API key.
- Works with any MCP client that runs local (stdio) servers: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, and others.
Authenticating the MCP server
Pass your API key with--api-key-auth. The server works in the key’s environment (sandbox or production). Create keys in the dashboard under Developers. See Manage API keys.
MCP server security and credentials
- To limit an agent, use an API key with a restricted role, or start the server with
--scope read. - Do not commit API keys. Rotate a key if it is ever committed or exposed.
- We recommend enabling human confirmation for write or destructive operations in your MCP client.
Installing the Tirdad MCP server
This needs Node.js 20 or later and an API key.~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json. Save the file and restart the client.
Limit the tools. Add "--scope", "read" to the arguments for read-only access. Repeat --scope to combine read, write, and delete. Without --scope, every tool is mounted. Add "--mode", "dynamic" to expose three discovery tools (list_tools, describe_tool_input, execute_tool) instead of one tool per operation.
What can you ask the MCP server?
Once connected, you can ask your AI assistant to:- “List my customers” or “Get customer by id …”
- “Create a subscription for customer … on plan …”
- “Get plan by id …” or “List plans”
- “Get usage for subscription …”
Which tools the MCP server exposes
The server exposes the Tirdad API as MCP tools (one tool per OpenAPI operation). We recommend enabling human confirmation of tools and exercising caution when using the Tirdad MCP with other servers to avoid prompt injection attacks.
For the full list, see your MCP client’s tool list after connecting or the API Reference.
Troubleshooting the MCP server
Related MCP and API references
- API Reference: full list of Tirdad API operations (each maps to an MCP tool).