meridian-silkdev/meridian-mcp

MCP server for the **Meridian** business-services platform. Exposes services, service requests, workflow steps, payments and meetings as Model Context Protocol tools and resources. MCP is a protocol, not a host-specific plugin format — this server runs unchanged in **Claude Code, Codex CLI, Claude Desktop, pi**, or any other MCP-compatible client.
Listed on the official MCP Registry as io.github.meridian-silkdev/meridian-mcp, and on Glama.
Install
Or once published:
Configure
Copy .env.example or set env vars directly:
| Var | Description | Default |
|-----|-------------|---------|
| MERIDIAN_API_URL | Meridian app base URL | http://localhost:3000 |
| MERIDIAN_API_KEY | mrd_ API key (Better Auth) for REST calls | *(none — tools return placeholder hint until set)* |
| DATABASE_URL | Optional direct DB access fallback | |
| MERIDIAN_MCP_LOG_LEVEL | debug/info/warn/error | info |
More: /.well-known/agent-configuration exposes **Agent Auth** discovery (capability-based, short-lived JWTs, device-auth/CIBA approval). Agents can use either a long-lived mrd_ key or scoped Agent Auth grants — see meridian-skills meridian-api skill.
Without MERIDIAN_API_KEY every tool still responds — it explains what endpoint would be called and what to configure, so the server is safe to run in dry-run / demo mode.
Run
Claude Code
Or drop a .mcp.json in your project root (shareable with a team, checked into git):
Codex CLI
Codex reads MCP servers from ~/.codex/config.toml (or a project-scoped .codex/config.toml for a trusted project):
Or via the CLI: codex mcp add meridian -- npx -y @meridiantoolkit/mcp. The same config is shared by Codex CLI, the IDE extension, and the ChatGPT desktop app.
Codex has no plugin/skill system (unlike Claude Code and pi) — its equivalent of meridian-plugin/meridian-skills is just this MCP server plus project guidance. Copy AGENTS.md.example into your project's AGENTS.md for the same tool-usage guidance the skills packages give elsewhere.
Claude Desktop / pi
Add to your MCP config (Claude Desktop: claude_desktop_config.json; pi: .pi/settings.json → mcpServers, or pi --mcp):
Tools
| Tool | Description |
|------|-------------|
| meridian_status | Check API connectivity/config and list available tools/resources. No params. Works the same in every client — this replaces the pi-only meridian_status extension tool from meridian-plugin so status-checking isn't tied to one host. |
| list_services | List services (filter: categorySlug, isActive, countryCode) |
| get_service | Get service by id/slug with formConfig |
| list_categories | List service categories |
| list_service_requests | List requests (filter: status, customerId, providerId, limit) |
| get_service_request | Get request by id with steps |
| create_service_request | Create request (serviceId, answers, customTitle) |
| update_request_status | Patch request status (prefer advance_step) |
| get_workflow_status | Current phase + all requestSteps |
| advance_step | Complete current step → next step |
| list_request_steps | All RequestSteps in order |
| get_payment_status | Payment row for a request |