{
  "mcp_version": "2025-03-26",
  "name": "Optiq Code",
  "description": "Deterministic code context engine for AI agents. Index repositories, search code with natural language, resolve symbol relationships.",
  "url": "https://api.optiqcode.com/mcp",
  "icon": "https://optiqcode.com/favicon-96x96.png",
  "transport": {
    "type": "streamable-http",
    "url": "https://api.optiqcode.com/mcp"
  },
  "authentication": {
    "type": "bearer",
    "token_url": "https://optiqcode.com/dashboard/api-keys",
    "documentation_url": "https://optiqcode.com/docs#agent-auth",
    "oauth_metadata_url": "https://optiqcode.com/.well-known/oauth-authorization-server"
  },
  "server_info": {
    "name": "optiq-code",
    "version": "1.0.0",
    "instructions": "Optiq Code is a deterministic context engine for software repositories. Use optiq_search to find code with natural language queries. Use optiq_index to index a new directory. Use optiq_repos to list indexed repositories. Use optiq_status to check indexing progress. All search results include confidence scores (0-1) — filter results below 0.45 for best quality."
  },
  "tools": [
    {
      "name": "optiq_search",
      "description": "Search indexed code using natural language. Returns ranked results with function signatures, call graphs, and confidence scores between 0 and 1.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Natural language search query describing what code you are looking for" },
          "repo_id": { "type": "string", "description": "Repository identifier to scope the search to a specific indexed repo" },
          "limit": { "type": "number", "description": "Maximum number of results to return (1-50)", "default": 10, "minimum": 1, "maximum": 50 },
          "intent": { "type": "string", "enum": ["navigate", "understand", "debug", "refactor"], "description": "Search intent hint to improve ranking relevance" }
        },
        "required": ["query"]
      }
    },
    {
      "name": "optiq_index",
      "description": "Index a directory for code search. Reads all source files, parses ASTs, resolves imports, and builds dependency graphs across 12 languages (Python, TypeScript, JavaScript, TSX, Rust, Go, Java, C, C++, Ruby, PHP, C#).",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": { "type": "string", "description": "Absolute directory path to index for code search" },
          "fresh": { "type": "boolean", "description": "Force a clean re-index from scratch, ignoring incremental cache", "default": false }
        },
        "required": ["path"]
      }
    },
    {
      "name": "optiq_repos",
      "description": "List all indexed repositories and their current status including file counts, languages detected, and last indexed timestamp.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": { "type": "string", "description": "Optional directory path to check if a specific directory is indexed" }
        }
      }
    },
    {
      "name": "optiq_status",
      "description": "Check the status of an indexing job. Returns progress percentage, files processed, and completion state.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "job_id": { "type": "string", "description": "Job ID returned from the optiq_index tool when indexing was started" }
        },
        "required": ["job_id"]
      }
    }
  ],
  "resources": [],
  "links": {
    "documentation": "https://optiqcode.com/docs",
    "developers": "https://optiqcode.com/developers",
    "openapi": "https://optiqcode.com/openapi.json",
    "pricing": "https://optiqcode.com/pricing",
    "status": "https://optiqcode.com/status",
    "support": "https://optiqcode.com/contact"
  }
}