{"id":50454155,"url":"https://github.com/mizcausevic-dev/mcp-aeo-server","last_synced_at":"2026-06-01T01:05:42.365Z","repository":{"id":357459321,"uuid":"1236319944","full_name":"mizcausevic-dev/mcp-aeo-server","owner":"mizcausevic-dev","description":"MCP server exposing AEO Protocol declarations as four tools (fetch, inspect, get_claim, well_known_url). Drop-in for Claude Desktop, Cursor, or any MCP-compatible agent. Ships with conforming MCP Tool Cards for every tool. Part of the Kinetic Gain Protocol Suite.","archived":false,"fork":false,"pushed_at":"2026-05-12T21:40:34.000Z","size":53,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-12T22:30:20.725Z","etag":null,"topics":["aeo","aeo-protocol","ai-agents","anthropic","claude","kinetic-gain-protocol-suite","mcp","mcp-server","model-context-protocol","protocol-implementation","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/mizcausevic-dev/mcp-aeo-server","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mizcausevic-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-12T06:28:30.000Z","updated_at":"2026-05-12T21:40:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mizcausevic-dev/mcp-aeo-server","commit_stats":null,"previous_names":["mizcausevic-dev/mcp-aeo-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mizcausevic-dev/mcp-aeo-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fmcp-aeo-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fmcp-aeo-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fmcp-aeo-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fmcp-aeo-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mizcausevic-dev","download_url":"https://codeload.github.com/mizcausevic-dev/mcp-aeo-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fmcp-aeo-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33755379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aeo","aeo-protocol","ai-agents","anthropic","claude","kinetic-gain-protocol-suite","mcp","mcp-server","model-context-protocol","protocol-implementation","typescript"],"created_at":"2026-06-01T01:05:42.297Z","updated_at":"2026-06-01T01:05:42.357Z","avatar_url":"https://github.com/mizcausevic-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mcp-aeo-server\n\nAn **MCP server** that exposes [AEO Protocol](https://github.com/mizcausevic-dev/aeo-protocol-spec) declarations as tools any MCP-compatible AI agent can call — Claude Desktop, Cursor, [Codex CLI](https://github.com/anthropics/claude-cli), or any custom client.\n\nDrop the server config into your MCP client and the agent gains four tools:\n\n| Tool | What it does |\n|---|---|\n| `aeo_fetch` | Fetch the full `/.well-known/aeo.json` for an origin |\n| `aeo_inspect` | Return a structured summary (entity, claim count, audit mode) — cheaper for context-window-constrained agents |\n| `aeo_get_claim` | Extract a single claim by ID; surfaces available IDs when the requested one is missing |\n| `aeo_well_known_url` | Compute the canonical well-known URL without fetching |\n\nEach tool ships with a conforming [MCP Tool Card](https://github.com/mizcausevic-dev/mcp-tool-card-spec) document in [`tool-cards/`](tool-cards/).\n\n## Install\n\n```bash\nnpm install -g @mizcausevic-dev/mcp-aeo-server\n```\n\nOr run without installing via `npx`:\n\n```bash\nnpx @mizcausevic-dev/mcp-aeo-server\n```\n\n## Claude Desktop config\n\nAdd to your `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\\Claude\\`):\n\n```json\n{\n  \"mcpServers\": {\n    \"aeo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mizcausevic-dev/mcp-aeo-server\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The four `aeo_*` tools will appear in Claude's tools panel and the model can invoke them directly. Try:\n\n\u003e *\"Use the aeo_inspect tool to show me what mizcausevic-dev.github.io declares about itself.\"*\n\nClaude will call `aeo_inspect({ origin: \"https://mizcausevic-dev.github.io\" })` and respond with the entity summary it received.\n\n## Cursor / Continue / other MCP clients\n\nAny client that speaks MCP over stdio works. Point its server config at `npx @mizcausevic-dev/mcp-aeo-server` with no arguments.\n\n## Tools\n\n### `aeo_fetch`\n```json\n{ \"origin\": \"https://mizcausevic-dev.github.io\" }\n```\nReturns the full conforming AEO document as JSON.\n\n### `aeo_inspect`\n```json\n{ \"origin\": \"https://mizcausevic-dev.github.io\" }\n```\nReturns:\n```json\n{\n  \"protocol\": \"0.1\",\n  \"entity\": {\n    \"id\": \"https://mizcausevic-dev.github.io/#person\",\n    \"type\": \"Person\",\n    \"name\": \"Miz Causevic\",\n    \"canonical_url\": \"https://mizcausevic-dev.github.io/\"\n  },\n  \"primary_source_count\": 4,\n  \"verification_count\": 3,\n  \"claim_count\": 6,\n  \"claim_ids\": [\"current-role\", \"location\", \"years-experience\", \"live-products\", \"primary-stack\", \"authored-spec\"],\n  \"audit_mode\": \"none\"\n}\n```\n\n### `aeo_get_claim`\n```json\n{ \"origin\": \"https://mizcausevic-dev.github.io\", \"claim_id\": \"years-experience\" }\n```\nReturns the single matching claim, or — if the ID doesn't exist — `{ \"error\": \"claim_not_found\", \"available_claim_ids\": [...] }`.\n\n### `aeo_well_known_url`\n```json\n{ \"origin\": \"https://example.com/\" }\n```\nReturns `{ \"url\": \"https://example.com/.well-known/aeo.json\" }`.\n\n## How this fits the Kinetic Gain Protocol Suite\n\n- The **server itself** uses AEO Protocol semantics (Tool Cards published in [`tool-cards/`](tool-cards/), conforming to [mcp-tool-card-spec](https://github.com/mizcausevic-dev/mcp-tool-card-spec))\n- The **tools** read AEO Protocol documents conforming to [aeo-protocol-spec](https://github.com/mizcausevic-dev/aeo-protocol-spec)\n- Together they close a loop: an AEO declaration somewhere on the web → an MCP server that lets any AI agent reason about it\n\n## Conformance\n\n- **AEO Protocol** support: Level 1 (Declare). Signature verification (L2) and audit submission (L3) are deferred to v0.2.\n- **MCP Tool Cards** support: Level 2 (Safety) for every tool, conforming to the v0.1 spec.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\nnpm test\nnpm run build\n```\n\nTests use a small in-process HTTP server (Node `node:http`) to serve a fixture AEO document. No external network required.\n\n## Compatibility\n\n- Node `18+`\n- `@modelcontextprotocol/sdk` `^1.0`\n- Tested with Claude Desktop and any MCP client speaking stdio\n\n## License\n\nAGPL-3.0.\n\n## Kinetic Gain Protocol Suite\n\n| Spec | Implementations |\n|---|---|\n| [AEO Protocol](https://github.com/mizcausevic-dev/aeo-protocol-spec) | [aeo-sdk-python](https://github.com/mizcausevic-dev/aeo-sdk-python) · [aeo-sdk-typescript](https://github.com/mizcausevic-dev/aeo-sdk-typescript) · [aeo-sdk-rust](https://github.com/mizcausevic-dev/aeo-sdk-rust) · [aeo-sdk-go](https://github.com/mizcausevic-dev/aeo-sdk-go) · [aeo-sdk-swift](https://github.com/mizcausevic-dev/aeo-sdk-swift) · [aeo-cli](https://github.com/mizcausevic-dev/aeo-cli) · [aeo-crawler](https://github.com/mizcausevic-dev/aeo-crawler) |\n| [Prompt Provenance](https://github.com/mizcausevic-dev/prompt-provenance-spec) | — |\n| [Agent Cards](https://github.com/mizcausevic-dev/agent-cards-spec) | — |\n| [AI Evidence Format](https://github.com/mizcausevic-dev/ai-evidence-format-spec) | — |\n| [MCP Tool Cards](https://github.com/mizcausevic-dev/mcp-tool-card-spec) | **mcp-aeo-server** (this) |\n\n---\n\n**Connect:** [LinkedIn](https://www.linkedin.com/in/mirzacausevic/) · [Kinetic Gain](https://kineticgain.com) · [Medium](https://medium.com/@mizcausevic/) · [Skills](https://mizcausevic.com/skills/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Fmcp-aeo-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmizcausevic-dev%2Fmcp-aeo-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Fmcp-aeo-server/lists"}