{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bvjn9vh8fb4n","handle":"mcp-kanka","url":"https://wellknown.network/agents/mcp-kanka","links":{"self":"https://wellknown.network/agents/mcp-kanka/record.json","html":"https://wellknown.network/agents/mcp-kanka","markdown":"https://wellknown.network/agents/mcp-kanka/record.md","api":"https://wellknown.network/api/v1/agents/mcp-kanka","status":"https://wellknown.network/api/v1/agents/mcp-kanka/status","claim":"https://wellknown.network/agents/mcp-kanka/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-kanka/claim.json","badge":"https://wellknown.network/agents/mcp-kanka/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-kanka/history","tools":"https://wellknown.network/api/v1/agents/mcp-kanka/tools"},"ard":{"identifier":"urn:air::server:mcp-kanka","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-kanka","summary":"MCP server for Kanka API integration","description":"# MCP-Kanka\n\nMCP (Model Context Protocol) server for Kanka API integration. This server provides AI assistants with tools to interact with Kanka campaigns, enabling CRUD operations on various entity types like characters, locations, organizations, and more.\n\nThis package is designed specifically to serve the needs of [Teghrim](https://github.com/ervwalter/teghrim) but may be useful to others working with Kanka and MCP.\n\n## Features\n\n- **Entity Management**: Create, read, update, and delete Kanka entities\n- **Search & Filter**: Search entities by name with partial matching, filter by type/tags/date\n- **Batch Operations**: Process multiple entities in a single request\n- **Posts Management**: Create, update, and delete posts (notes) on entities\n- **Markdown Support**: Automatic conversion between Markdown and HTML with entity mention preservation\n- **Type Safety**: Full type hints and validation\n- **Client-side Filtering**: Enhanced filtering beyond API limitations\n- **Sync Support**: Efficient synchronization with timestamp tracking and Kanka's native lastSync feature\n- **Timestamp Tracking**: All entities include created_at and updated_at timestamps\n\n## Requirements\n\n- Python 3.10 or higher (3.13.5 recommended)\n- Kanka API token and campaign ID\n\n## Installation\n\n### From PyPI\n```bash\npip install mcp-kanka\n```\n\n### From Source (using uv)\n```bash\ngit clone https://github.com/ervwalter/mcp-kanka.git\ncd mcp-kanka\nuv sync --all-groups\nuv pip install -e .\n```\n\n### From Source (using pip)\n```bash\ngit clone https://github.com/ervwalter/mcp-kanka.git\ncd mcp-kanka\npip install -e .\n```\n\n## Quick Start\n\n### Adding to Claude Desktop\n\n1. Set up your environment variables:\n   - `KANKA_TOKEN`: Your Kanka API token\n   - `KANKA_CAMPAIGN_ID`: Your campaign ID\n\n2. Add to Claude Desktop config:\n```json\n{\n  \"mcpServers\": {\n    \"kanka\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"mcp_kanka\"],\n      \"env\": {\n        \"KANKA_TOKEN\": \"your-token\",\n        \"KANKA_CAMPAIGN_ID\": \"your-cam…","publisher":null,"homepage":"https://github.com/ervwalter/mcp-kanka#readme","repository":"https://github.com/ervwalter/mcp-kanka#readme","version":"1.1.0","license":"MIT","protocols":["mcp"],"tags":["api","kanka","mcp","rpg","tabletop"],"pricing":null,"endpoints":[{"url":"pypi:mcp-kanka","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":"mcp-kanka","registry":"pypi","observedAt":"2026-11-09T16:25:50.606Z","publishedAt":"2025-06-22T13:55:20.242643Z","latestVersion":"1.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-kanka","url":"https://pypi.org/project/mcp-kanka/","firstSeenAt":"2026-09-10T02:23:08.277Z","fetchedAt":"2026-11-09T16:23:54.321Z","normalizedAt":"2026-11-09T16:23:54.321Z"}]},"firstSeenAt":"2026-09-10T02:23:08.277Z","updatedAt":"2026-11-09T16:25:50.607Z"}