Instaclean MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Instaclean MCP
Remote Model Context Protocol server for Instaclean. It gives AI clients such as ChatGPT, Claude, Cursor, and internal operations agents a standardized tool interface while keeping Mithril as the source of truth for authorization, pricing, booking, availability, dispatch, and audit rules.
Architecture
ChatGPT / Claude / Cursor / Ops Agent
|
| MCP over HTTP
v
instaclean-mcp (/mcp)
|
| authenticated HTTP/JSON
v
api.tryinstaclean.com
|
v
MithrilThe MCP server does not connect directly to PostgreSQL and does not duplicate Mithril business logic.
Related MCP server: SecureMCP Agent Hub
Tools
Read
search_customers- admin customer search by name, email, or phonelist_dispatch_requests- admin urgent-help/replacement queuelist_my_service_requests- current customer's urgent-help/replacement requestslist_booking_services- active Direct booking serviceslist_available_workers- verified professionals eligible for a serviceget_booking- current customer's booking details
Write
create_admin_booking- admin-assisted booking with explicit customer consentcreate_urgent_help_request- non-medical urgent household helprequest_replacement- replacement request for an owned bookingassign_worker- vetted worker assignment through Mithril's assignment endpointupdate_service_request- triage/matching/resolve/cancel transitions
Payments, refunds, payouts, pricing mutation, account deletion, and verification mutation are intentionally not exposed in the initial MCP surface.
Authentication
The server supports two modes.
passthrough (default)
The MCP request must contain:
Authorization: Bearer <mithril-access-token>The token is forwarded to Mithril. Mithril validates the user and enforces customer/admin authorization. This is the preferred model for user-scoped MCP connections.
service
Use this only for an internal Instaclean operations agent with a dedicated active admin account. The caller authenticates to the MCP server with MCP_API_KEY; the MCP server then calls Mithril using the configured Direct gateway token and actor user ID.
Required environment variables:
AUTH_MODE=service
MCP_API_KEY=...
MITHRIL_DIRECT_TOKEN=...
MITHRIL_ACTOR_USER_ID=...Do not use a customer account as the service actor and do not put these values in source control.
Origin protection
MCP clients normally make server-to-server requests without an Origin header. If an Origin header is present, the server requires it to match ALLOWED_ORIGINS. This protects the HTTP MCP endpoint against browser-based DNS-rebinding attacks.
Development
Requires Node.js 22+.
cp .env.example .env
npm install
npm run check
npm run devThe local endpoints are:
GET/POST http://127.0.0.1:3000/mcp
GET http://127.0.0.1:3000/healthThe MCP SDK's HTTP handler also retains stateless compatibility with 2025-era clients while supporting the current 2026 protocol.
Example Cursor configuration
For service mode or development clients that support static headers:
{
"mcpServers": {
"instaclean": {
"type": "http",
"url": "https://mcp.tryinstaclean.com/mcp",
"headers": {
"Authorization": "Bearer ${env:INSTACLEAN_MCP_TOKEN}"
}
}
}
}Never commit the token to a Cursor configuration checked into the repository.
Deployment
The included Dockerfile is suitable for Fly.io or another container host. Production should expose only HTTPS externally.
For Fly.io, create the app and set secrets rather than editing fly.toml with credentials:
fly secrets set \
MITHRIL_API_URL=https://api.tryinstaclean.com \
AUTH_MODE=service \
MCP_API_KEY=... \
MITHRIL_DIRECT_TOKEN=... \
MITHRIL_ACTOR_USER_ID=...Then point mcp.tryinstaclean.com to the deployed service.
Next security milestone: OAuth
The initial server deliberately supports bearer passthrough and a service-agent mode without implementing a second identity system. Before broadly connecting third-party users, add OAuth 2.1 / MCP Protected Resource Metadata so ChatGPT, Claude, and other clients can obtain scoped Mithril tokens interactively instead of receiving manually copied access tokens.
Mithril remains responsible for role checks and business invariants even after OAuth is added.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Supervised API-write gateway for AI agents with policy, human approval and execution receipts.
Governed access to sensitive data, secrets and APIs for AI agents. A signed proof for each decision.
Credential broker for AI agents: scoped, revocable API access with policy enforcement and audit.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to retrieve customer, order, ticket, policy, and agreement information, and to prepare or execute state-changing support actions like escalations and follow-ups with confirmation and access control.-
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to securely call enterprise MCP tools with tenant-scoped RBAC, human approvals, audit logging, and multi-tool workflows across customer, order, document, and ticket data.-
- AlicenseAqualityCmaintenanceEnables AI agents to browse customers, bookings, and availability while any booking creation or cancellation stays gated behind a human-approved, single-use token cryptographically bound to the exact arguments. Runs over stdio or Streamable HTTP and enforces the read/write separation in host code with a full audit trail.7MIT
- AlicenseNot gradedqualityBmaintenanceExposes scattered business REST APIs and read-only databases to AI clients through a single MCP endpoint with unified API-key authentication, service- and operation-level authorization, department-scoped filtering, masking, and audit logging. AI agents discover only the tools and data they are permitted to use, without needing to know endpoint addresses, SQL, or credentials.MIT