{
  "metadata": {
    "project": "MetaMesh-UGA",
    "version": "1.0.0",
    "last_updated": "2026-08-06T09:11:04.676Z",
    "docs_version": "1.0.0"
  },
  "api": {
    "base_url": "https://api.metamesh-uga.dev",
    "endpoints": [
      {
        "path": "/health",
        "method": "GET",
        "description": "Health check"
      },
      {
        "path": "/v1/tools",
        "method": "GET",
        "description": "List tools (paginated)",
        "query": {
          "limit": "number",
          "offset": "number",
          "sort": "popularity|trust|recent",
          "category": "string",
          "min_trust": "number"
        }
      },
      {
        "path": "/v1/search",
        "method": "GET",
        "description": "Full-text search across tools",
        "query": {
          "q": "string"
        }
      },
      {
        "path": "/v1/recommend",
        "method": "GET",
        "description": "Recommend tools",
        "query": {
          "q": "string"
        }
      },
      {
        "path": "/v1/call",
        "method": "POST",
        "description": "Execute a tool via REST (x402-aware)",
        "body": {
          "tool": "string",
          "params": "object"
        }
      },
      {
        "path": "/v1/route",
        "method": "GET",
        "description": "Smart routing decision"
      },
      {
        "path": "/mcp",
        "method": "POST",
        "description": "MCP hub JSON-RPC (tools/list leads with metamesh.* + stripe.*; params.filter for token-scoped listing)",
        "body": {
          "jsonrpc": "2.0",
          "id": "number",
          "method": "string",
          "params": "object"
        }
      },
      {
        "path": "/v1/mcp/info",
        "method": "GET",
        "description": "MCP hub status: native analysis/control tools + Stripe MCP federation"
      },
      {
        "path": "/v1/metrics/summary",
        "method": "GET",
        "description": "JSON usage metrics summary"
      },
      {
        "path": "/v1/metrics/prometheus",
        "method": "GET",
        "description": "Prometheus metrics"
      },
      {
        "path": "/v1/dashboard/health",
        "method": "GET",
        "description": "Dashboard health metrics"
      },
      {
        "path": "/v1/dashboard/usage",
        "method": "GET",
        "description": "Daily usage (7 days)"
      },
      {
        "path": "/v1/dashboard/errors",
        "method": "GET",
        "description": "Daily errors (7 days)"
      },
      {
        "path": "/v1/features",
        "method": "GET",
        "description": "Enabled gateway features"
      },
      {
        "path": "/v1/x402/info",
        "method": "GET",
        "description": "x402 payment protocol status"
      },
      {
        "path": "/v1/agent/register",
        "method": "POST",
        "description": "Register an AI agent (returns agent_id + api_key)",
        "body": {
          "name": "string",
          "email": "string?"
        }
      },
      {
        "path": "/v1/agent/wallet",
        "method": "GET",
        "description": "Agent balance & spend (X-Agent-Id + X-Agent-Key)"
      },
      {
        "path": "/v1/agent/topup",
        "method": "POST",
        "description": "Create Stripe Checkout to top up balance",
        "body": {
          "amount_usd": "number"
        }
      },
      {
        "path": "/v1/agent/transactions",
        "method": "GET",
        "description": "Agent transaction history"
      },
      {
        "path": "/v1/stripe/webhook",
        "method": "POST",
        "description": "Stripe webhook (credits balance on paid top-up)"
      },
      {
        "path": "/docs",
        "method": "GET",
        "description": "This dynamic API documentation"
      },
      {
        "path": "/v1/admin/discovery",
        "method": "POST",
        "description": "Trigger real registry discovery (X-Admin-Key)",
        "query": {
          "max_pages": "number",
          "reset": "boolean"
        }
      },
      {
        "path": "/v1/admin/discovery/status",
        "method": "GET",
        "description": "Discovery status"
      }
    ]
  },
  "payments": {
    "models": [
      {
        "name": "prepaid-credit",
        "description": "Agents top up a USD balance via Stripe, then per-call pricing is debited automatically. Authenticate with X-Agent-Id + X-Agent-Key.",
        "flow": [
          "POST /v1/agent/register",
          "POST /v1/agent/topup { amount_usd }",
          "POST /v1/call (balance debited)",
          "GET /v1/agent/wallet"
        ]
      },
      {
        "name": "x402-crypto",
        "description": "Pay per-call in USDC on Base. On HTTP 402, read `accepts` and retry with an X-PAYMENT header.",
        "status_endpoint": "/v1/x402/info"
      }
    ]
  },
  "tools_sample": [
    {
      "name": "example.echo",
      "description": "Echo tool for testing MCP integration",
      "version": "1.0.0",
      "category": "demo"
    },
    {
      "name": "github",
      "description": "GitHub MCP Server - List PRs, issues, repo info, and search code",
      "version": "1.0.0",
      "category": "development"
    },
    {
      "name": "openai",
      "description": "Validate GPTBot and OAI-SearchBot IP addresses. Remote MCP validate_ip tool.",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "kubernetes",
      "description": "Kubernetes cluster management",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "gmail",
      "description": "Gmail read and send emails",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "filesystem",
      "description": "Read, write, and search local files",
      "version": "1.0.0",
      "category": "system"
    },
    {
      "name": "notion",
      "description": "Notion page and database ops",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "google-calendar",
      "description": "Google Calendar operations",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "cloudflare",
      "description": "Cloudflare account management",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "slack",
      "description": "Slack messaging integration",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "docker",
      "description": "Docker container management",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "fetch",
      "description": "Fetch web content and convert to markdown",
      "version": "1.0.0",
      "category": "web"
    },
    {
      "name": "gcp",
      "description": "Google Cloud Platform management",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "deepseek",
      "description": "DeepSeek AI model access",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "postgres",
      "description": "PostgreSQL database queries",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "jira",
      "description": "Jira issue management",
      "version": "1.0.0",
      "category": "development"
    },
    {
      "name": "aws",
      "description": "AWS multi-service operations",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "supabase",
      "description": "Supabase database and auth",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "atlassian",
      "description": "Atlassian Jira/Confluence operations",
      "version": "1.0.0",
      "category": "development"
    },
    {
      "name": "perplexity",
      "description": "Perplexity AI search",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "google-drive",
      "description": "Google Drive file access",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "firecrawl",
      "description": "Firecrawl web scraping",
      "version": "1.0.0",
      "category": "web"
    },
    {
      "name": "brave-search",
      "description": "Web search via Brave Search API",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "vercel",
      "description": "Vercel deployment and domains",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "gdrive",
      "description": "Access and manage Google Drive files",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "google-maps",
      "description": "Google Maps geocoding and search",
      "version": "1.0.0",
      "category": "location"
    },
    {
      "name": "sqlite",
      "description": "SQLite database operations",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "huggingface",
      "description": "Hugging Face model inference",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "stripe",
      "description": "Stripe payment operations",
      "version": "1.0.0",
      "category": "finance"
    },
    {
      "name": "snowflake",
      "description": "Snowflake data warehouse",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "gitlab",
      "description": "GitLab project operations",
      "version": "1.0.0",
      "category": "development"
    },
    {
      "name": "elevenlabs",
      "description": "ElevenLabs text-to-speech",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "tavily",
      "description": "Tavily AI search",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "sequentialthinking",
      "description": "Structured thinking and reasoning",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "zapier",
      "description": "Zapier workflow triggers",
      "version": "1.0.0",
      "category": "automation"
    },
    {
      "name": "redis",
      "description": "Redis key-value operations",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "google-search",
      "description": "Google Programmable Search",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "memory",
      "description": "Give every AI you use one shared, permanent memory. Store once, recall in whichever AI you open.",
      "version": "1.0.0",
      "category": "commerce"
    },
    {
      "name": "shopify",
      "description": "Shopify store operations",
      "version": "1.0.0",
      "category": "commerce"
    },
    {
      "name": "todoist",
      "description": "Todoist task management",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "mongodb",
      "description": "MongoDB queries and updates",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "puppeteer",
      "description": "Browser automation via Puppeteer",
      "version": "1.0.0",
      "category": "automation"
    },
    {
      "name": "exa",
      "description": "Exa AI search engine",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "airtable",
      "description": "Airtable database operations",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "mysql",
      "description": "MySQL database queries",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "chatgpt",
      "description": "Interact with ChatGPT sessions",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "linear",
      "description": "MCP server for Linear project management and issue tracking",
      "version": "1.0.0",
      "category": "development"
    },
    {
      "name": "aws-kb-retrieval",
      "description": "AWS Knowledge Base retrieval",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "qdrant",
      "description": "Qdrant vector search",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "azure",
      "description": "Azure resource management",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "everart",
      "description": "Generate images via EverArt",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "pinecone",
      "description": "Pinecone vector DB operations",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "arxiv",
      "description": "Search and read arXiv papers",
      "version": "1.0.0",
      "category": "research"
    },
    {
      "name": "grafana",
      "description": "Grafana dashboards and alerts",
      "version": "1.0.0",
      "category": "monitoring"
    },
    {
      "name": "sentry",
      "description": "Sentry error monitoring",
      "version": "1.0.0",
      "category": "monitoring"
    },
    {
      "name": "neondb",
      "description": "Neon PostgreSQL management",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "bing-search",
      "description": "Bing web search",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "jina",
      "description": "Jina AI embeddings and search",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "chroma",
      "description": "Chroma vector database queries",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "llamaindex",
      "description": "LlamaIndex RAG operations",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "time",
      "description": "A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "langfuse",
      "description": "Langfuse LLM observability",
      "version": "1.0.0",
      "category": "monitoring"
    },
    {
      "name": "browserbase",
      "description": "Browser automation cloud",
      "version": "1.0.0",
      "category": "automation"
    },
    {
      "name": "replicate",
      "description": "Replicate model inference",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "confluence",
      "description": "Confluence page management",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "weaviate",
      "description": "Weaviate vector search",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "apple-notes",
      "description": "Read Apple Notes",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "clickup",
      "description": "ClickUp project management",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "wolfram",
      "description": "Wolfram Alpha computation",
      "version": "1.0.0",
      "category": "knowledge"
    },
    {
      "name": "bash",
      "description": "Execute bash commands safely",
      "version": "1.0.0",
      "category": "system"
    },
    {
      "name": "calendly",
      "description": "Calendly event scheduling",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "salesforce",
      "description": "Salesforce CRM operations",
      "version": "1.0.0",
      "category": "crm"
    },
    {
      "name": "asknews",
      "description": "Search news with AskNews",
      "version": "1.0.0",
      "category": "news"
    },
    {
      "name": "outlook",
      "description": "Microsoft Outlook email",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "crawl4ai",
      "description": "Web crawling and extraction",
      "version": "1.0.0",
      "category": "web"
    },
    {
      "name": "netlify",
      "description": "Netlify site deployment",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "calcom",
      "description": "Cal.com booking management",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "spotify",
      "description": "Full Spotify Web API coverage - albums, artists, playlists, player controls, and more.",
      "version": "1.0.0",
      "category": "ai"
    },
    {
      "name": "airbnb",
      "description": "Airbnb search and booking data",
      "version": "1.0.0",
      "category": "travel"
    },
    {
      "name": "twilio",
      "description": "Twilio SMS and voice",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "discord",
      "description": "Discord bot operations",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "datadog",
      "description": "Datadog monitoring and logs",
      "version": "1.0.0",
      "category": "monitoring"
    },
    {
      "name": "youtube",
      "description": "YouTube search and data",
      "version": "1.0.0",
      "category": "media"
    },
    {
      "name": "duckduckgo",
      "description": "DuckDuckGo web search",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "devdocs",
      "description": "Search developer documentation",
      "version": "1.0.0",
      "category": "search"
    },
    {
      "name": "calculator",
      "description": "Mathematical expression evaluation",
      "version": "1.0.0",
      "category": "utility"
    },
    {
      "name": "twitter",
      "description": "Twitter/X social posting",
      "version": "1.0.0",
      "category": "social"
    },
    {
      "name": "dagster",
      "description": "Dagster data orchestration",
      "version": "1.0.0",
      "category": "data"
    },
    {
      "name": "trello",
      "description": "Trello board management",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "curl",
      "description": "HTTP requests via curl",
      "version": "1.0.0",
      "category": "web"
    },
    {
      "name": "telegram",
      "description": "Telegram bot messaging",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "dropbox",
      "description": "Dropbox file operations",
      "version": "1.0.0",
      "category": "productivity"
    },
    {
      "name": "zendesk",
      "description": "Zendesk support tickets",
      "version": "1.0.0",
      "category": "support"
    },
    {
      "name": "dapr",
      "description": "Dapr distributed runtime",
      "version": "1.0.0",
      "category": "infrastructure"
    },
    {
      "name": "whatsapp",
      "description": "WhatsApp assistants, messaging, broadcasts, and analytics for your iZap account, over OAuth.",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "intercom",
      "description": "Intercom customer messaging",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "docusign",
      "description": "DocuSign document signing",
      "version": "1.0.0",
      "category": "legal"
    },
    {
      "name": "sendgrid",
      "description": "Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes.",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "mailgun",
      "description": "Mailgun email sending",
      "version": "1.0.0",
      "category": "communication"
    },
    {
      "name": "hackernews",
      "description": "Hacker News stories and comments",
      "version": "1.0.0",
      "category": "news"
    }
  ],
  "changelog": [
    {
      "version": "1.0.0",
      "changes": "Initial release with MCP server, tool discovery, REST API, and dynamic docs.",
      "released_at": "2026-06-24 22:26:31"
    }
  ],
  "guides": {
    "rest_call": "curl -X POST https://api.metamesh-uga.dev/v1/call -H 'Content-Type: application/json' -d '{\"tool\":\"example.echo\",\"params\":{\"message\":\"hi\"}}'",
    "mcp_config": "{ \"mcpServers\": { \"metamesh-uga\": { \"url\": \"https://api.metamesh-uga.dev/mcp\", \"transport\": \"http\" } } }",
    "mcp_integration": "https://api.metamesh-uga.dev/mcp"
  }
}