{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xszsxz72wbxw","handle":"odoo-mcp-xyt","url":"https://wellknown.network/agents/odoo-mcp-xyt","links":{"self":"https://wellknown.network/agents/odoo-mcp-xyt/record.json","html":"https://wellknown.network/agents/odoo-mcp-xyt","markdown":"https://wellknown.network/agents/odoo-mcp-xyt/record.md","api":"https://wellknown.network/api/v1/agents/odoo-mcp-xyt","status":"https://wellknown.network/api/v1/agents/odoo-mcp-xyt/status","claim":"https://wellknown.network/agents/odoo-mcp-xyt/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/odoo-mcp-xyt/claim.json","badge":"https://wellknown.network/agents/odoo-mcp-xyt/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/odoo-mcp-xyt/history","tools":"https://wellknown.network/api/v1/agents/odoo-mcp-xyt/tools"},"ard":{"identifier":"urn:air::server:odoo-mcp-xyt","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"odoo-mcp-xyt","summary":"MCP Server for Odoo Integration","description":"# UVX 方式安装 odoo mcp 服务\n\n```\n{\n    \"mcpServers\": {\n        \"odoo-mcp-xyt\": {\n            \"command\": \"uvx\",\n            \"args\": [\n                \"odoo-mcp-xyt==2.1.0.0\"\n            ],\n            \"env\": {\n                \"ODOO_URL\": \"\",\n                \"ODOO_DB\": \"\",\n                \"ODOO_USERNAME\": \"\",\n                \"ODOO_PASSWORD\": \"\"\n            }\n        }\n    }\n}\n```\n\n# Odoo MCP Server\n\nAn MCP server implementation that integrates with Odoo ERP systems, enabling AI assistants to interact with Odoo data and functionality through the Model Context Protocol.\n\n**[中文文档 / Chinese Documentation](README_zh.md)**\n\n## Quick Start\n\n1. **Install Python 3.10+** and create a virtual environment\n2. **Clone and install** the project:\n   ```bash\n   git clone <repository-url>\n   cd odoo-mcp-xyt\n   pip install -e .\n   ```\n3. **Configure Odoo connection** in `odoo_config.json`:\n   ```json\n   {\n     \"url\": \"https://your-odoo-instance.com\",\n     \"db\": \"your-database-name\",\n     \"username\": \"your-username\",\n     \"password\": \"your-password-or-api-key\"\n   }\n   ```\n4. **Run the server**:\n   ```bash\n   python -m odoo_mcp\n   ```\n5. **Test with MCP Inspector**:\n   ```bash\n   npx @modelcontextprotocol/inspector\n   ```\n\n## Features\n\n- **Comprehensive Odoo Integration**: Full access to Odoo models, records, and methods\n- **XML-RPC Communication**: Secure connection to Odoo instances via XML-RPC\n- **Flexible Configuration**: Support for config files and environment variables\n- **Resource Pattern System**: URI-based access to Odoo data structures\n- **Error Handling**: Clear error messages for common Odoo API issues\n- **Stateless Operations**: Clean request/response cycle for reliable integration\n\n## Tools\n\n- **execute_method**\n\n  - Execute a custom method on an Odoo model\n  - Inputs:\n    - `model` (string): The model name (e.g., 'res.partner')\n    - `method` (string): Method name to execute\n    - `args` (optional array): Positional arguments\n    - `kwargs` (optional object): Keyword arguments…","publisher":null,"homepage":"https://github.com/xyt-mcp/odoo-mcp-xyt","repository":"https://github.com/xyt-mcp/odoo-mcp-xyt","version":"2.4.0.2","license":"MIT","protocols":["mcp"],"tags":["odoo","mcp","server"],"pricing":null,"endpoints":[{"url":"pypi:odoo-mcp-xyt","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":"code.documentation","name":"Code Documentation","confidence":0.848,"provenance":"derived"}],"categories":["code","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-mcp-xyt","registry":"pypi","observedAt":"2026-11-03T20:29:38.157Z","publishedAt":"2025-12-08T11:28:11.326607Z","latestVersion":"2.4.0.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"odoo-mcp-xyt","url":"https://pypi.org/project/odoo-mcp-xyt/","firstSeenAt":"2026-09-10T08:26:06.709Z","fetchedAt":"2026-11-03T20:28:21.584Z","normalizedAt":"2026-11-03T20:28:21.584Z"}]},"firstSeenAt":"2026-09-10T08:26:06.709Z","updatedAt":"2026-11-03T20:29:38.157Z"}