{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yem23fvbuzhq","handle":"codex-mcp-http-bridge","url":"https://wellknown.network/agents/codex-mcp-http-bridge","links":{"self":"https://wellknown.network/agents/codex-mcp-http-bridge/record.json","html":"https://wellknown.network/agents/codex-mcp-http-bridge","markdown":"https://wellknown.network/agents/codex-mcp-http-bridge/record.md","api":"https://wellknown.network/api/v1/agents/codex-mcp-http-bridge","status":"https://wellknown.network/api/v1/agents/codex-mcp-http-bridge/status","claim":"https://wellknown.network/agents/codex-mcp-http-bridge/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codex-mcp-http-bridge/claim.json","badge":"https://wellknown.network/agents/codex-mcp-http-bridge/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:codex-mcp-http-bridge","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codex-mcp-http-bridge","summary":"HTTP/OAuth bridge for connecting Codex to remote MCP servers","description":"# Codex MCP HTTP Bridge\n\nA Python package that enables OpenAI Codex to connect to remote MCP (Model Context Protocol) servers via HTTPS with OAuth 2.1 authentication.\n\n## Features\n\n- **stdio to HTTP Bridge**: Converts Codex's stdio MCP protocol to HTTP requests\n- **OAuth 2.1 Authentication**: Secure authentication using Bearer tokens\n- **Long-lived Tokens**: Personal access tokens that last up to 1 year\n- **Multiple Servers**: Configure and connect to multiple remote MCP servers\n- **Easy Setup**: Interactive CLI wizard for configuration\n- **Comprehensive Logging**: Debug connectivity issues with detailed logs\n\n## Installation\n\n```bash\npip install codex-mcp-http-bridge\n```\n\nOr install from source:\n\n```bash\ngit clone https://github.com/gurucloudai/codex-mcp-http-bridge.git\ncd codex-mcp-http-bridge\npip install -e .\n```\n\n## Quick Start\n\n### 1. Generate a Personal Access Token\n\nFirst, generate a personal access token from your MCP server provider (e.g., GuruCloudAI):\n\n```bash\n# Log into https://www.gurucloudai.com\n# Navigate to MCP Manager\n# Click \"Generate Token\" or use the API:\ncurl -X POST https://www.gurucloudai.com/api/personal-access-tokens \\\n  -H \"Authorization: Bearer YOUR_SESSION_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"Codex Bridge Token\"}'\n```\n\n### 2. Configure the Bridge\n\nRun the interactive setup wizard:\n\n```bash\ncodex-mcp-http-bridge setup\n```\n\nThis will guide you through:\n- Adding your MCP server URL\n- Entering your personal access token\n- Configuring multiple servers (optional)\n\nConfiguration is saved to `~/.codex-mcp-bridge/config.json` with secure permissions (chmod 600).\n\n### 3. Test the Connection\n\n```bash\ncodex-mcp-http-bridge test --server my-knowledge-base\n```\n\n### 4. Generate Codex Configuration\n\n```bash\ncodex-mcp-http-bridge codex-config >> ~/.codex/config.toml\n```\n\n### 5. Restart Codex\n\nRestart Codex to load the new MCP servers. Your remote servers will now be available to Codex!\n\n## Configuration\n\n### Manual Configurati…","publisher":null,"homepage":"https://github.com/gurucloudai/codex-mcp-http-bridge#readme","repository":"https://github.com/gurucloudai/codex-mcp-http-bridge#readme","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","codex","oauth","bridge","proxy"],"pricing":null,"endpoints":[{"url":"pypi:codex-mcp-http-bridge","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"declared"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codex-mcp-http-bridge","registry":"pypi","observedAt":"2026-09-09T12:29:37.119Z","publishedAt":"2025-11-13T18:57:33.072096Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codex-mcp-http-bridge","url":"https://pypi.org/project/codex-mcp-http-bridge/","firstSeenAt":"2026-09-09T12:27:09.115Z","fetchedAt":"2026-09-09T13:19:56.508Z","normalizedAt":"2026-09-09T13:19:56.508Z"}]},"firstSeenAt":"2026-09-09T12:27:09.115Z","updatedAt":"2026-09-09T12:29:37.119Z"}