{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xm7926nhegh5","handle":"opcua-mcp-server","url":"https://wellknown.network/agents/opcua-mcp-server","links":{"self":"https://wellknown.network/agents/opcua-mcp-server/record.json","html":"https://wellknown.network/agents/opcua-mcp-server","markdown":"https://wellknown.network/agents/opcua-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/opcua-mcp-server","status":"https://wellknown.network/api/v1/agents/opcua-mcp-server/status","claim":"https://wellknown.network/agents/opcua-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/opcua-mcp-server/claim.json","badge":"https://wellknown.network/agents/opcua-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/opcua-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/opcua-mcp-server/tools"},"ard":{"identifier":"urn:air::server:opcua-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"opcua-mcp-server","summary":"MCP server exposing OPC UA read/write/browse/method/history tools (FastMCP + python-opcua).","description":"# OPC UA MCP Server\n\nA Model Context Protocol (MCP) server that provides seamless integration with OPC UA servers. This server enables AI assistants and other MCP clients to interact with industrial automation systems through standardized OPC UA communication protocols.\n\n## Overview\n\nThis MCP server acts as a bridge between AI assistants and OPC UA servers, allowing for:\n- Reading sensor data and system variables\n- Writing control values to actuators and systems\n- Browsing OPC UA node hierarchies\n- Calling OPC UA methods for system operations\n- Batch operations for multiple nodes\n\n## Tools\n\nSee the central per-tool reference in **[docs/examples.md](https://github.com/midhunxavier/OPCUA-MCP/blob/main/docs/examples.md)**; the shared tool surface is defined in **[contract/tools.json](https://github.com/midhunxavier/OPCUA-MCP/blob/main/contract/tools.json)**.\n\n## Features\n\n### Key Capabilities\n\n- **Automatic Connection Management**: Handles OPC UA client lifecycle with proper connection setup and teardown\n- **Type-Safe Operations**: Automatic type conversion based on existing node data types\n- **Error Handling**: Comprehensive error reporting for debugging and monitoring\n- **Async Support**: Built on FastMCP for efficient asynchronous operations\n- **Configurable**: Environment-based endpoint, security policy and credentials\n\n## Installation\n\n### Prerequisites\n\n- Python 3.10 or higher\n- Access to an OPC UA server (local or remote)\n- UV package manager (recommended) or pip\n\n### From PyPI (recommended)\n\n```bash\nuvx opcua-mcp-server            # run without installing\nuv tool install opcua-mcp-server   # or install permanently\npip install opcua-mcp-server       # or with pip\n```\n\nPoint it at your OPC UA endpoint:\n\n```bash\nexport OPCUA_SERVER_URL=\"opc.tcp://localhost:4840\"\n```\n\n### Registering with Claude Desktop\n\nRather than editing `claude_desktop_config.json` by hand, let the server write it:\n\n```bash\nopcua-mcp-server --install claude-desktop --url opc.tcp://192.168.0.10…","publisher":null,"homepage":null,"repository":null,"version":"0.3.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:opcua-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"content.writing","name":"Writing & Editing","confidence":0.802,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["content","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":"opcua-mcp-server","registry":"pypi","observedAt":"2026-09-12T08:20:45.196Z","publishedAt":"2026-09-12T05:58:17.697911Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"opcua-mcp-server","url":"https://pypi.org/project/opcua-mcp-server/","firstSeenAt":"2026-09-12T08:20:33.764Z","fetchedAt":"2026-09-12T08:20:33.764Z","normalizedAt":"2026-09-12T08:20:33.764Z"}]},"firstSeenAt":"2026-09-12T08:20:33.764Z","updatedAt":"2026-09-12T08:20:45.196Z"}