{
  "markdown": "# GeniusFlow\n\n**Evidence is the product.**\n**Federation and MCP are the interfaces.**\n**RWA / CIRCLE is the proving ground.**\n**Research is the laboratory.**\n\nPinned claims about real-world entities. Live source re-check. Fail-closed packages. Public MCP.\n\n```text\nUSE NOW      Evidence API + MCP     this README\nRESEARCH     labeled experiments    not a product feature\nROADMAP      registry / reliance / settlement    future\n```\n\n[Try Federation](https://geniusflow-federation.vercel.app/api/dossier?entity=CIRCLE) · [Connect MCP](#connect-mcp) · [CIRCLE example](#circle-example) · [What this does not claim](#what-this-does-not-claim)\n\n---\n\n## Use GeniusFlow\n\nEvidence-backed claims that can be independently re-checked.\n\nNo account. Live origin:\n\n```text\nhttps://geniusflow-federation.vercel.app\n```\n\n| Do this | Call |\n|---------|------|\n| Open an entity card | `GET /api/dossier?entity=CIRCLE` |\n| Re-check a pinned string | `POST /api/verify` |\n| Admit or withhold | `POST /api/package` |\n| Cite | `POST /api/cite` with `{kind, id, claim}` |\n| MCP | `POST /api/mcp` — registry `io.github.Kaydeep0/geniusflow-federation` |\n\nSLA: best-effort Vercel hobby. No promised uptime.\n\nA missing circulating figure stays **UNKNOWN**. That is product behavior, not an empty cell to fill in.\n\n---\n\n## How it works\n\n```text\nEntity → Claim → Grounding → Verify → Package → Cite\n```\n\n1. **Entity** — a specimen card (CIRCLE is the public proving ground).\n2. **Claim** — a published sentence on that card.\n3. **Grounding** — `source_url` + `expected` substring, taken from the claim. Do not invent `expected`.\n4. **Verify** — another machine re-fetches the source and reports whether the substring is still there.\n5. **Package** — admit or withhold. Invented attestations are withheld.\n6. **Cite** — a cite packet over a published claim object.\n\nLiteral string re-check. Not semantic fact-checking. Not “the world is true.”\n\nPages (`kaydeep0.github.io/eigenstate-research`) and Federation are **different surfaces**. Snapshot identities can differ. Do not treat them as one synchronized view.\n\n---\n\n## CIRCLE example\n\n```bash\n# 1. Entity card\ncurl -sS \"https://geniusflow-federation.vercel.app/api/dossier?entity=CIRCLE\"\n\n# 2. Take grounding from claims[0] — do not invent expected\n# 3. Verify, package, cite: see examples/\n```\n\nCopy/paste scripts (curl + python3, no clone of the private engine):\n\n- [`examples/01_verify_circle.sh`](examples/01_verify_circle.sh) — dossier → verify\n- [`examples/02_status_and_unknown.sh`](examples/02_status_and_unknown.sh) — status + UNKNOWN circulating\n- [`examples/03_package_and_cite.sh`](examples/03_package_and_cite.sh) — package admit + cite packet\n\nMachine index: [llms.txt](https://geniusflow-federation.vercel.app/llms.txt) · OpenAPI: [openapi.json](https://geniusflow-federation.vercel.app/openapi.json)\n\n---\n\n## Connect MCP\n\nRemote. No private filesystem path.\n\n```json\n{\n  \"mcpServers\": {\n    \"geniusflow-federation\": {\n      \"url\": \"https://geniusflow-federation.vercel.app/api/mcp\"\n    }\n  }\n}\n```\n\nOfficial registry: [`io.github.Kaydeep0/geniusflow-federation`](https://registry.modelcontextprotocol.io/)\n\nTools (live `tools/list`): `gf_status` `gf_dossier` `gf_report_feed` `gf_cite` `gf_verify` `gf_package` `gf_darshan` `gf_return_wire` `gf_openapi`\n\n`gf_darshan` and `gf_return_wire` are experimental adapters. Core evidence tools are `gf_dossier` / `gf_verify` / `gf_package` / `gf_cite` / `gf_status`.\n\n---\n\n## Research\n\nExperiments testing whether maintained state helps independent AI observers recover position and, separately, allocate future attention.\n\nThese are **labeled experiments**. They are not the product on the first screen.\n\n| Experiment | Public status |\n|------------|----------------|\n| H_CHATGPT_POSITION R1 | Task-specific: maintained multi-artifact package C recovered position better than thinner packages A/B (n=15). Not a memory product. Not a general information-advantage proof. |\n| H_CHATGPT_POSITION A1 | Frozen. 0/25 observers. Waiting on ChatGPT upload apparatus. Not run. |\n| Phase 8 | Apparatus reachable; prospective experiment not yet started. T0 none. Not a live world-tracking feature. Not an experimental result. |\n\n---\n\n## Roadmap\n\nExplicitly future. Not current product claims.\n\n- RWA registry as something others rely on\n- Shared reliance\n- Settlement\n\nCIRCLE is inspectable today. That does not make a complete RWA registry.\n\n---\n\n## What this does not claim\n\n- Persistent AI memory product\n- Better than RAG / Graphiti / Mem0 / Letta\n- Complete RWA registry\n- Settlement or reliance\n- Real-time world model\n- Proven information advantage\n- Synchronized websites (Pages and Federation snapshot ids can differ)\n- Production SLA\n- `$500T+` tokenized-market figure\n\n---\n\n## Public surfaces\n\n| Surface | URL |\n|---------|-----|\n| Live API | https://geniusflow-federation.vercel.app |\n| Human site (secondary) | https://kaydeep0.github.io/eigenstate-research/ |\n| This repository | https://github.com/Kaydeep0/eigenstate-research |\n| MCP | https://geniusflow-federation.vercel.app/api/mcp |\n| MCP declaration | https://geniusflow-federation.vercel.app/server.json |\n\nThe runtime engine repository is private.\n\n## Also on this site\n\nHuman research Pages (secondary; not the Evidence API):\n\n- [Methodology](https://kaydeep0.github.io/eigenstate-research/methodology/)\n- [Verify walkthrough](https://kaydeep0.github.io/eigenstate-research/verify-walkthrough/)\n- [Mode A walkthrough](https://kaydeep0.github.io/eigenstate-research/mode-a-walkthrough/)\n\n",
  "bytes": 5533,
  "sha": "2cf8585ece4bef3e229d8425e91342a90feaa96a60f54449d66e596b30541e4b",
  "repo_slug": "kaydeep0/eigenstate-research",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kaydeep0_geniusflow_federation_ec5d4f03/readme"
}