Titan Frameworks

MCP server that indexes and serves token-efficient docs for LangChain, LlamaIndex, Ollama, and XRPL (xrpl.js / xrpl-py).

Live Streamable HTTP: https://titan-frameworks-production.up.railway.app/mcp
Paid with x402: $0.001 USDC on Base or 1000 drops XRP / 0.001 RLUSD on XRPL mainnet.

Agent discovery: llms.txt · Smithery smithery.yaml · MCP Registry server.json

Tools

Tool	Purpose
search_ai_framework_docs	Keyword search over local Markdown chunks
fetch_latest_syntax	Working snippets, imports, migration notes
diagnose_framework_error	Stack-trace → deprecated API → exact fix

Connect a client

{
  "mcpServers": {
    "titan-frameworks": {
      "url": "https://titan-frameworks-production.up.railway.app/mcp"
    }
  }
}

x402-capable clients send PAYMENT-SIGNATURE / X-PAYMENT after a 402. Local stdio (Cursor folder / npm run dev) does not charge.

HTTP endpoints

Path	Notes
GET /health	liveness + index stats
GET /llms.txt	agent discovery
GET /tools	tool list + live pricing
GET /.well-known/x402	x402scan resource index
GET /.well-known/x402.json	full payment requirements + bazaar metadata
GET /.well-known/mcp/server-card.json	Smithery static card
ALL /mcp	Streamable HTTP MCP (paid in production)

Run locally (stdio)

cd titan-frameworks
npm install
npm run dev

Project config is in .cursor/mcp.json. Seed docs ship in src/data/seed-fallback.json.

npm run index-docs

HTTP mode (Vercel / Railway)

npm run dev:http
# POST http://127.0.0.1:3333/mcp

npm run build
npm start

Railway uses railway.toml (npm run start). Vercel rewrites to api/index.ts.

x402 micropayments

Production billing is on. POST https://titan-frameworks-production.up.railway.app/mcp without a payment header returns 402.

Rail	Price	Network	Facilitator
USDC	$0.001	Base (eip155:8453)	PayAI
XRP	1000 drops (0.001 XRP)	XRPL mainnet (xrpl:0)	T54
RLUSD	0.001	XRPL mainnet (xrpl:0)	T54

A raw wallet transfer is not an x402 proof. Clients retry /mcp with PAYMENT-SIGNATURE / X-PAYMENT. Local stdio (npm run dev) does not charge.

To reproduce the gate locally: X402_ENABLED=true (mock) plus X402_USDC_LIVE=true / X402_XRPL_LIVE=true for live verify/settle.

Password-gated admin

Production dashboard: https://titan-frameworks-production.up.railway.app/admin

It is not a public stats page. Login is a password checked against ADMIN_SECRET_KEY. Unauthenticated /api/admin/* calls return 401. The old public /admin/api/stats route is gone (404).

Layout

src/app/           Next.js admin UI + /api/admin routes
src/components/    Admin dashboard React components
src/tools/         MCP tool handlers
src/mcp/tools.ts   tool registration (includes xrpl)
src/indexer/       xrpl.js crawl targets
src/services/      search, indexer, store, x402, earnings, discovery
src/data/          JSON index, syntax catalog, known errors
src/types/         Zod schemas + TS types
scripts/           index-docs, x402-smoke
server.json        MCP Registry remote listing
smithery.yaml      Smithery remote listing
glama.json         Glama maintainer claim