{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_59vyaerfx28f","handle":"odoo-model-mcp","url":"https://wellknown.network/agents/odoo-model-mcp","links":{"self":"https://wellknown.network/agents/odoo-model-mcp/record.json","html":"https://wellknown.network/agents/odoo-model-mcp","markdown":"https://wellknown.network/agents/odoo-model-mcp/record.md","api":"https://wellknown.network/api/v1/agents/odoo-model-mcp","status":"https://wellknown.network/api/v1/agents/odoo-model-mcp/status","claim":"https://wellknown.network/agents/odoo-model-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/odoo-model-mcp/claim.json","badge":"https://wellknown.network/agents/odoo-model-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/odoo-model-mcp/history","tools":"https://wellknown.network/api/v1/agents/odoo-model-mcp/tools"},"ard":{"identifier":"urn:air::server:odoo-model-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"odoo-model-mcp","summary":"MCP server exposing Odoo model registry without a database connection","description":"# odoo-model-mcp\n\nMCP server that exposes Odoo's model registry (fields, inheritance, methods)\nwithout needing a database connection.\n\nPoint it at any Odoo project directory and get instant, structured answers about\nmodels, fields, method override chains, and inheritance graphs — powered by\nOdoo's own `MetaModel` registry loaded in-memory.\n\n> **Status:** Pre-alpha (0.1.0a1). Works with Odoo 16–19.\n\n## How it works\n\n1. **MCP server** (this package) receives tool calls via stdio.\n2. It auto-detects the Odoo project structure (odoo-bin, addons paths, venv).\n3. A **persistent worker subprocess** is spawned in the project's own Python\n   venv, loading the full model registry once (~4 seconds).\n4. Subsequent queries are served over a Unix domain socket in **1–15 ms**.\n5. Workers auto-shutdown after 10 minutes of inactivity.\n\nEach project gets its own isolated worker process, so you can work with multiple\nOdoo versions simultaneously without conflicts.\n\n## Installation\n\n```bash\n# With uv (recommended)\nuv tool install odoo-model-mcp\n\n# With pip\npip install odoo-model-mcp\n```\n\n## Usage with Claude Code\n\nAdd to your `~/.claude.json` (global) or project `.claude/settings.local.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"odoo-model-registry\": {\n      \"type\": \"stdio\",\n      \"command\": \"odoo-model-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\nIf installed with `uv` and not on PATH:\n\n```json\n{\n  \"mcpServers\": {\n    \"odoo-model-registry\": {\n      \"type\": \"stdio\",\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--project\", \"/path/to/odoo-model-mcp\", \"odoo-model-mcp\"]\n    }\n  }\n}\n```\n\n## Tools\n\nAll tools accept a `project_path` pointing to the root of an Odoo project.\nAddons paths and the Odoo source location are auto-detected from the project\nstructure (or can be overridden with `addons_paths`). Modules can be excluded\nby name with `exclude_modules` (useful when a module has unresolvable Python\ndependencies).\n\n### `detect_project_info`\n\nDetect an Odoo project's structure without loading the r…","publisher":{"name":"Marc Durepos, Bemade Inc.","url":null},"homepage":"https://github.com/bemade/odoo-model-mcp","repository":"https://github.com/bemade/odoo-model-mcp","version":"0.1.0a2","license":null,"protocols":["mcp"],"tags":["odoo","mcp","model-context-protocol","introspection","registry"],"pricing":null,"endpoints":[{"url":"pypi:odoo-model-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"}],"categories":["dev"],"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":"odoo-model-mcp","registry":"pypi","observedAt":"2026-11-09T22:23:44.898Z","publishedAt":"2026-03-10T02:08:10.181146Z","latestVersion":"0.1.0a2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"odoo-model-mcp","url":"https://pypi.org/project/odoo-model-mcp/","firstSeenAt":"2026-09-10T08:26:06.949Z","fetchedAt":"2026-11-09T22:22:32.460Z","normalizedAt":"2026-11-09T22:22:32.460Z"}]},"firstSeenAt":"2026-09-10T08:26:06.949Z","updatedAt":"2026-11-09T22:23:44.898Z"}