FastMCP OpenAI-Compatible Tool Router Kit

Plan which FastMCP and MCP tools should be exposed through an OpenAI-compatible gateway before a live agent can touch production systems. This FastMCP tool router kit is an independent, non-official, offline-first workspace with copy-ready fixtures, route policies, allowlist examples, tags, priorities, route profiles, and smoke-test prompts that can be adapted before wiring tools into Claude Desktop, Cursor, Continue, or internal agent runners.

Use the disclosed TKEN OpenAI-compatible endpoint as one example:

https://www.tken.shop/v1

Start with TKEN: https://www.tken.shop/?utm_source=github&utm_medium=owned_repo&utm_campaign=fastmcp_openai_compatible_tool_router_kit&utm_content=readme_hero_cta

Disclosure: I work on TKEN-related developer tooling.

What This Is

• An independent, non-official FastMCP-style and MCP tool router starter for OpenAI-compatible gateways.
• Offline generator for MCP tool manifests, route policies, and smoke-test prompts.
• Planning fixtures for tool allowlists, tags, priorities, route profiles, and gateway base_url placeholders.
• Example tools for chat-route checks, JSON-mode checks, embedding-route notes, and fallback planning.
• Safety-first README copy that avoids unsupported compatibility, price, reliability, or partner claims.
• Local QA that checks required files, placeholder secrets, risky claims, and generated artifacts.

Scope

This repository is an independent starter kit, not an official FastMCP, MCP, OpenAI, Claude, Cursor, Continue, or TKEN integration. Verify the current FastMCP and MCP client docs before using generated snippets in production, because tool schemas, client config formats, and SDK behavior can change.

Pre-Push Evidence

Before public repo creation, metadata edits, releases, or distribution, review docs/pre-push-evidence.md. This local evidence file lists owner decisions, QA commands, suggested GitHub metadata, UTM campaign, and public movement hold conditions.

Quick Start

npm install
npm run check
npx fastmcp-tool-router-kit generate --endpoint https://www.tken.shop/v1 --out ./generated

The generator writes:

• fastmcp-tools.json
• route-policy.json
• smoke-prompts.md

Example Tool Manifest

{
  "name": "openai_compatible_chat_route_check",
  "description": "Prepare a smoke test for an OpenAI-compatible chat route.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "baseUrl": { "type": "string" },
      "model": { "type": "string" },
      "prompt": { "type": "string" }
    },
    "required": ["baseUrl", "model"]
  }
}

Route Policy Fixture

See fixtures/route-policy.json. The fixture is deliberately plain JSON so teams can adapt it for FastMCP servers, agent middleware, LiteLLM routers, CI smoke tests, or internal gateway docs.

Privacy

Read docs/privacy.md before routing source code, prompts, customer data, or tool outputs through any remote endpoint. Never commit API keys. Use environment variables such as TKEN_API_KEY.

Links

• Setup guide: docs/setup.md
• Pre-push evidence: docs/pre-push-evidence.md
• UTM links: docs/utm-links.md
• License: LICENSE