{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hw2ntbva722u","handle":"surreal-mcp","url":"https://wellknown.network/agents/surreal-mcp","links":{"self":"https://wellknown.network/agents/surreal-mcp/record.json","html":"https://wellknown.network/agents/surreal-mcp","markdown":"https://wellknown.network/agents/surreal-mcp/record.md","api":"https://wellknown.network/api/v1/agents/surreal-mcp","status":"https://wellknown.network/api/v1/agents/surreal-mcp/status","claim":"https://wellknown.network/agents/surreal-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/surreal-mcp/claim.json","badge":"https://wellknown.network/agents/surreal-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:surreal-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"surreal-mcp","summary":"MCP Server for SurrealDB - Bridge AI assistants with SurrealDB databases","description":"# SurrealDB MCP Server\n\n<div align=\"center\">\n  <img src=\"assets/images/surreal-logo.jpg\" alt=\"SurrealDB Logo\" width=\"200\">\n  \n  **A Model Context Protocol (MCP) server that enables AI assistants to interact with SurrealDB databases**\n  \n  [![Test](https://github.com/YOUR_USERNAME/surreal-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/YOUR_USERNAME/surreal-mcp/actions/workflows/test.yml)\n  [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)\n  [![FastMCP](https://img.shields.io/badge/FastMCP-2.11%2B-green)](https://github.com/jlowin/fastmcp)\n  [![SurrealDB](https://img.shields.io/badge/SurrealDB-2.0%2B-purple)](https://surrealdb.com/)\n</div>\n\n## =� Overview\n\nThe SurrealDB MCP Server bridges the gap between AI assistants and SurrealDB, providing a standardized interface for database operations through the Model Context Protocol. This enables LLMs to:\n\n- Execute complex SurrealQL queries\n- Perform CRUD operations on records\n- Manage graph relationships\n- Handle bulk operations efficiently\n- Work with SurrealDB's unique features like record IDs and graph edges\n\n## Features\n\n- **Full SurrealQL Support**: Execute any SurrealQL query directly\n- **Comprehensive CRUD Operations**: Create, read, update, delete with ease\n- **Graph Database Operations**: Create and traverse relationships between records\n- **Bulk Operations**: Efficient multi-record inserts\n- **Smart Updates**: Full updates, merges, and patches\n- **Type-Safe**: Proper handling of SurrealDB's RecordIDs\n- **Connection Pooling**: Efficient database connection management\n- **Multi-Database Support**: Override namespace/database per tool call\n- **Detailed Documentation**: Extensive docstrings for AI comprehension\n\n## =� Prerequisites\n\n- Python 3.10 or higher\n- SurrealDB instance (local or remote)\n- MCP-compatible client (Claude Desktop, MCP CLI, etc.)\n\n## =�\u000f Installation\n\n### Using uvx (Simplest - No Installation Required)\n\n```bash\n# Run directly fr…","publisher":null,"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:surreal-mcp","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":"code.documentation","name":"Code Documentation","confidence":0.882,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.791,"provenance":"derived"}],"categories":["code","data"],"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":"surreal-mcp","registry":"pypi","observedAt":"2026-09-10T13:21:42.572Z","publishedAt":"2025-12-05T16:23:50.870740Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"surreal-mcp","url":"https://pypi.org/project/surreal-mcp/","firstSeenAt":"2026-09-10T13:20:14.964Z","fetchedAt":"2026-09-10T13:20:14.964Z","normalizedAt":"2026-09-10T13:20:14.964Z"}]},"firstSeenAt":"2026-09-10T13:20:14.964Z","updatedAt":"2026-09-10T13:21:42.572Z"}