{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2dr74uhz2xc2","handle":"odooclaw-mcp","url":"https://wellknown.network/agents/odooclaw-mcp","links":{"self":"https://wellknown.network/agents/odooclaw-mcp/record.json","html":"https://wellknown.network/agents/odooclaw-mcp","markdown":"https://wellknown.network/agents/odooclaw-mcp/record.md","api":"https://wellknown.network/api/v1/agents/odooclaw-mcp","status":"https://wellknown.network/api/v1/agents/odooclaw-mcp/status","claim":"https://wellknown.network/agents/odooclaw-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/odooclaw-mcp/claim.json","badge":"https://wellknown.network/agents/odooclaw-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/odooclaw-mcp/history","tools":"https://wellknown.network/api/v1/agents/odooclaw-mcp/tools"},"ard":{"identifier":"urn:air::server:odooclaw-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"odooclaw-mcp","summary":"A modular, type-safe, and secure MCP server for interacting with Odoo 18 ORM","description":"# OdooClaw MCP\n\nStandalone MCP (Model Context Protocol) server for Odoo 18 over `stdio`.\n\n**MCP name:** `io.github.nicolasramos/odoo-mcp`  \n**PyPI package:** `odooclaw-mcp`  \n**Official CLI:** `odooclaw-mcp`\n\nBackward-compatible aliases are also installed:\n\n- `odoo-mcp`\n- `odoo-mcp-server`\n- `odoo-18-mcp-server`\n\n## Quick Start\n\n### 1) Install\n\n```bash\npip install odooclaw-mcp\n```\n\nFrom source:\n\n```bash\ngit clone https://github.com/nicolasramos/odooclaw-mcp.git\ncd odooclaw-mcp\npip install -e .\n```\n\n### 2) Configure environment\n\n```bash\ncp .env.example .env\n```\n\nRequired:\n\n```env\nODOO_URL=https://yourcompany.odoo.com\nODOO_DB=your_database\nODOO_USERNAME=your_username\nODOO_PASSWORD=your_password\n```\n\nOptional:\n\n```env\nODOO_MCP_DEFAULT_LIMIT=50\nODOO_MCP_MAX_LIMIT=80\nLOG_LEVEL=INFO\n```\n\n### 3) Validate and run\n\n```bash\nodooclaw-mcp --check-config\nodooclaw-mcp\n```\n\nAlternative:\n\n```bash\npython -m odoo_mcp\n```\n\n## MCP Client Configuration (stdio)\n\n```json\n{\n  \"mcpServers\": {\n    \"odoo\": {\n      \"command\": \"odooclaw-mcp\",\n      \"env\": {\n        \"ODOO_URL\": \"https://yourcompany.odoo.com\",\n        \"ODOO_DB\": \"your_database\",\n        \"ODOO_USERNAME\": \"your_username\",\n        \"ODOO_PASSWORD\": \"your_password\",\n        \"ODOO_MCP_DEFAULT_LIMIT\": \"50\",\n        \"ODOO_MCP_MAX_LIMIT\": \"80\"\n      }\n    }\n  }\n}\n```\n\n## Scope\n\n- 38+ MCP tools for Odoo operations (CRUD + business actions)\n- Pydantic validation for all tool payloads\n- Odoo 18 compatibility helpers (customer_rank / supplier_rank / payment_state)\n- Security guards (model allowlist, denylisted fields, action guard, unlink blocked)\n- Structured logging and audit actions\n\n## Security Model\n\nThe server uses standard Odoo JSON-RPC endpoints and executes operations as the\nconfigured Odoo session user.\n\nFor production, use a dedicated least-privilege Odoo account.\n\n## Production Notes\n\n- This is a `stdio` MCP server, not an HTTP API service.\n- Docker/Compose support is mainly for packaging or controlled runtime scenarios.\n- In nor…","publisher":null,"homepage":"https://github.com/nicolasramos/odooclaw-mcp/blob/main/README.md","repository":"https://github.com/nicolasramos/odooclaw-mcp/blob/main/README.md","version":"2.1.0","license":"MIT","protocols":["mcp"],"tags":["odoo","mcp","orm","api","server"],"pricing":null,"endpoints":[{"url":"pypi:odooclaw-mcp","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.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"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":"odooclaw-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:37.588Z","publishedAt":"2026-04-11T10:38:09.566393Z","latestVersion":"2.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"odooclaw-mcp","url":"https://pypi.org/project/odooclaw-mcp/","firstSeenAt":"2026-09-10T08:26:04.031Z","fetchedAt":"2026-11-03T20:28:18.476Z","normalizedAt":"2026-11-03T20:28:18.476Z"}]},"firstSeenAt":"2026-09-10T08:26:04.031Z","updatedAt":"2026-11-03T20:29:37.588Z"}