io.github.NeousAxis/aya-registry
Search 367k+ verified businesses; earn cashback when an agent routes a real purchase.
Open source Repository Open in the app JSON README (API)
About
Search 367k+ verified businesses; earn cashback when an agent routes a real purchase.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- neousaxis
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-09-08T05:23:48Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 03:02:07
- Updated
- 2026-08-29 03:02:07
- Origin id
io.github.NeousAxis/aya-registry
README
# AYA — The Independent AI Knowledge Registry
> AYA gives businesses sovereign control over how AI assistants see and recommend them — without depending on Google, OpenAI, or any single platform.
When someone asks ChatGPT, Claude, Gemini or any AI _"find me a cybersecurity consultant in Switzerland"_, the AI needs structured, verified data to answer. Today, that data is controlled by a handful of tech giants who decide who gets recommended.
**AYA is the independent alternative.** A structured registry accessible to ALL AIs — not just those from Google or OpenAI.
## MCP server: plug any agent into AYA
AYA runs a public **MCP server** (Model Context Protocol), so any MCP-compatible agent (Claude, Cursor, VS Code, ChatGPT, or your own) can query the registry directly. No API key, no signup, nothing to install.
| | |
|---|---|
| **Endpoint** | `https://ai-visionary.xyz/agents/mcp` |
| **Transport** | Streamable HTTP (remote, hosted in Switzerland) |
| **Authentication** | None |
| **Official MCP registry** | `io.github.NeousAxis/aya-registry` |
| **Builder guide** | [ai-visionary.xyz/for-agents](https://ai-visionary.xyz/for-agents) |
| **Discovery** | [`/.well-known/mcp.json`](https://ai-visionary.xyz/.well-known/mcp.json), [`/llms.txt`](https://ai-visionary.xyz/llms.txt) |
### MCP tools exposed
| Tool | What it does |
|------|--------------|
| `search_companies` | Search 367,000+ verified businesses by name, domain, sector or country |
| `get_company_details` | Full record for one company: AIO readability score, sector, country, ASR status |
| `index_company` | Add a real business the agent found that is not in AYA yet |
| `get_registry_stats` | Aggregate registry statistics |
| `get_cashback_offer` | Active cashback offer for a domain, as a signed token, before the agent recommends it |
| `claim_cashback` | Claim the cashback after a real, consumed transaction |
### Connect it
Claude Code:
```bash
claude mcp add --transport http aya-registry https://ai-visionary.xyz/agents/mcp
```
Any other MCP client (Claude Desktop, Cursor, VS Code):
```json
{
"mcpServers": {
"aya-registry": {
"type": "http",
"url": "https://ai-visionary.xyz/agents/mcp"
}
}
}
```
Implementation: [`app/agents/[transport]/route.ts`](https://github.com/NeousAxis/ai-visionary/blob/feature/pollen-agents/app/agents/%5Btransport%5D/route.ts), built with [`mcp-handler`](https://www.npmjs.com/package/mcp-handler) on top of the official [`@modelcontextprotocol/sdk`](https://github.com/modelcontextprotocol/typescript-sdk).
## How AYA works — Systemic Attraction
AYA doesn't connect to a single AI — every AI finds AYA naturally. Business data is published across multiple convergent sources, ensuring that all AI assistants — regardless of their provider — can access and recommend verified businesses:
| Source | What | URL |
|--------|------|-----|
| **MCP server** | Live tools any AI agent can call (search, details, cashback) | `ai-visionary.xyz/agents/mcp` |
| **API LLM-Friendly** | 5-field JSON per entity, optimized for AI consumption | `ai-visionary.xyz/api/aya/llm/{domain}` |
| **Crawlable HTML** | 367,000+ certificate pages with JSON-LD structured data | `ai-visionary.xyz/aya/e/{id}` |
| **GitHub Dataset** | One JSON file per entity (CC-BY-4.0) | [NeousAxis/aya-business-dataset](https://github.com/NeousAxis/aya-business-dataset) |
| **HuggingFace Dataset** | CSV + JSONL, ML-ready (CC-BY-4.0) | [NeousAxis/aya-business-dataset](https://huggingface.co/datasets/NeousAxis/aya-business-dataset) |
When an AI sees the same data across API + HTML + GitHub + HuggingFace → it considers it stable and reliable → it uses it.
## Why sovereign?
| Locked-in model | AYA model |
|-----------------|-----------|
| Your visibility depends on one AI provider | Your data is accessible to ALL AIs |
| Platform changes → you disappear | Structured data is permanent and portable |
| You pay to be listed on each platform | You own your data, AYA distributes it everywhere |
| One algorithm decides your ranking | Multiple independent sources confirm your identity |
## What's live today
| | |
|---|---|
| **Entities indexed** | 367,000+ |
| **Countries** | 206 |
| **Certified (ASR)** | 9 |
| **API** | Free, no auth, 30 req/min |
| **Bilingual** | FR + EN |
## API Endpoints
```
Search: GET /api/aya/search?q=restaurant+geneve
Entity: GET /api/aya/entity/{domain}
LLM: GET /api/aya/llm/{domain}?lang=en|fr
Stats: GET /api/aya/stats
Registry: GET /api/aya/live
```
No authentication. No API key. Just call the endpoint.
### LLM-Optimized Response
```json
{
"name": "Chainlink",
"what_it_does": "Blockchain infrastructure connecting external data to smart contracts.",
"for_who": "Web3 developers and blockchain protocols.",
"category": "Web3 / Oracle",
"location": "Global"
}
```
## For businesses
Your business already exists online — but can AI assistants find and recommend it?
1. Get diagnosed by [AYO](https://ai-visionary.xyz/diagnostic) → receive your AI readability score (AIO, 0-100)
2. Get your structured data files (ASR) → install them on your site
3. Get listed in the AYA registry → become recommendable by every AI assistant
**The result**: when someone asks any AI about your industry, your city, your services — you show up. Independently of which AI they use.
> [Start your free diagnostic](https://ai-visionary.xyz/diagnostic)
## Links
- [ai-visionary.xyz](https://www.ai-visionary.xyz) — Website
- [ai-visionary.xyz/developers](https://www.ai-visionary.xyz/developers) — API & data documentation
- [ai-visionary.xyz/aya](https://www.ai-visionary.xyz/aya) — Public registry
- [GitHub Dataset](https://github.com/NeousAxis/aya-business-dataset) — Open data (JSON, CC-BY-4.0)
- [HuggingFace Dataset](https://huggingface.co/datasets/NeousAxis/aya-business-dataset) — ML-ready (CSV + JSONL, CC-BY-4.0)
---
Built in Geneva, Switzerland by [AI Visionary](https://www.ai-visionary.xyz) | 2026
*AYA is a platform by AI Visionary. The business dataset is published under CC-BY-4.0 to enable systemic attraction.*