Metadata-Version: 2.4
Name: ckg-agent-protocols
Version: 0.1.0
Summary: Agent protocol stack as traversable knowledge graphs — A2A v1.0, x402, MCP 2026-07-28, ERC-8004, Google ADK, SDK ecosystem. 460 nodes, 8 domains, SHA-256 provenance. MCP-native.
Project-URL: Homepage, https://graphify.md
Project-URL: Repository, https://github.com/Yarmoluk/ckg-agent-protocols
Project-URL: Full Enterprise Stack, https://graphify.md/pro/
Author-email: Daniel Yarmoluk <daniel.yarmoluk@gmail.com>
License: MIT
Keywords: a2a,agent-payments,agent-protocols,ai-agents,erc-8004,google-adk,knowledge-graph,mcp,x402
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: cryptography>=42.0.0
Requires-Dist: mcp<2.0.0,>=1.0.0
Provides-Extra: serve
Requires-Dist: httpx>=0.27.0; extra == 'serve'
Requires-Dist: starlette>=0.41.0; extra == 'serve'
Requires-Dist: uvicorn>=0.30.0; extra == 'serve'
Description-Content-Type: text/markdown

# ckg-agent-protocols

Agent protocol stack as traversable knowledge graphs — 8 domains, 460 nodes, SHA-256 source provenance.

| Domain | Nodes | Coverage |
|--------|-------|----------|
| a2a-protocol | 73 | A2A Protocol v1.0 — transport, Agent Card, task lifecycle, 10 RPC methods |
| x402-protocol | 55 | x402 Payment Protocol — HTTP 402, PAYMENT-REQUIRED, settlement schemes |
| a2a-x402-integration | 58 | A2A × x402 — Standalone/Embedded flows, signing patterns, 7 error codes |
| a2a-sdk-ecosystem | 52 | a2a-sdk · @a2a-js/sdk · Inspector · TCK · migration guides |
| google-adk-a2a | 48 | RemoteA2aAgent · to_a2a() · ADK 2.0 graph workflows (Experimental) |
| mcp-protocol | 56 | MCP 2026-07-28 — Streamable HTTP only, OAuth 2.1, Python/TS SDK v2 |
| erc8004-agent-trust | 46 | ERC-8004 — on-chain identity (ERC-721), reputation, validation registries |
| a2a-master | 72 | A2A Communication Master — full 7-step flow, cross-protocol constraint matrix |

## Install

```bash
pip install ckg-agent-protocols
```

## MCP server

```bash
uvx ckg-agent-protocols
```

Claude Desktop config:

```json
{
  "mcpServers": {
    "agent-protocols": {
      "command": "uvx",
      "args": ["ckg-agent-protocols"]
    }
  }
}
```

## HTTP server (x402 + A2A Agent Card)

```bash
pip install "ckg-agent-protocols[serve]"
python -m ckg_agent_protocols.serve
```

- `/.well-known/agent-card.json` — A2A v1.0 Agent Card
- `/.well-known/mcp/pricing.json` — pricing tiers
- `/mcp` — MCP Streamable HTTP endpoint
- Free: 10 calls/hr · x402: $0.010/call USDC Base L2 · Dev: $29/mo

## Tools

- `list_domains()` — list all 8 domains
- `search_concepts(domain, query)` — find concepts by keyword
- `query_ckg(domain, concept, depth)` — traverse the graph from a concept
- `get_prerequisites(domain, concept)` — full upstream prerequisite chain
- `verify_source(domain, concept)` — return source URL + SHA-256 hash

## Provenance

Every node carries `source_url` and `source_hash` (SHA-256 of source bytes at extraction time).

```bash
curl -s <source_url> | sha256sum  # compare to source_hash
```

---

By [Graphify.md](https://graphify.md) · patent-pending methodology · [benchmark paper](https://github.com/Yarmoluk/ckg-benchmark)
