io.github.saviodamato/agentrank-mcp
Find real, verifiable businesses with provenance and source URLs - for AI agents.
Open source Open in the app JSON README (API)
About
Find real, verifiable businesses with provenance and source URLs - for AI agents.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- saviodamato
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Last push
- 2026-07-10T04:46:12Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 04:01:22
- Updated
- 2026-08-29 04:01:22
- Origin id
io.github.saviodamato/agentrank-mcp
README
# AgentRank MCP server
**MCP server for AI agents to search real, source-backed businesses.** Every result
carries a source URL and a trust score, so your agent acts on facts — never invented
phone numbers or addresses. Coverage: **Brazil, US, Europe** (~2.7M businesses, growing).
Works with any [MCP](https://modelcontextprotocol.io) client (Claude Desktop, Cursor, …).
Public beta · free key, no invite · website: https://agentsafepath.com ·
official MCP registry: `io.github.saviodamato/agentrank-mcp`.
## Use cases
- Business search / company lookup with source-backed data.
- Local business search for agents (city + category + contact).
- Company profile: contacts, address, website, provenance.
- Source-backed company data instead of hallucinated details.
## Tools
- **`search_businesses(intent, limit=10)`** — find businesses by a natural-language
intent (e.g. `"farmácia em Copacabana com telefone"`, `"software company in California"`).
Returns ranked results with `fit_score`, `trust_score`, justification, risks and the
**source URL** of each fact.
- **`get_business_profile(company_id)`** — full profile of a result: location, contact
channels, hours, offers, policies and evidence, each with provenance and source.
## 1. Get an API key
Register your agent (free, no invite) at
**https://agentsafepath.com/registrar.html** — you receive a key once. It identifies
your agent and is sent as `Authorization: Bearer <key>`.
## 2. Add it to your MCP client
### Claude Desktop
Edit `claude_desktop_config.json` (Settings → Developer → Edit Config) and add:
```json
{
"mcpServers": {
"agentrank": {
"command": "uvx",
"args": ["agentrank-mcp"],
"env": { "AGENTRANK_API_KEY": "ak_your_key_here" }
}
}
}
```
Restart Claude Desktop. You'll see `search_businesses` and `get_business_profile`
available. (`uvx` comes with [uv](https://docs.astral.sh/uv/); or use the "From source"
option below.)
### Cursor
Add the same block under `mcpServers` in your Cursor MCP settings.
### From source (no packaging)
```bash
pip install -r requirements.txt
AGENTRANK_API_KEY=ak_your_key_here python -m agentrank_mcp.server
```
And point your client's `command` at `python` with `args`
`["-m", "agentrank_mcp.server"]` and the folder on `PYTHONPATH`.
## Environment variables
| Var | Required | Default |
|---|---|---|
| `AGENTRANK_API_KEY` | yes | — |
| `AGENTRANK_BASE_URL` | no | `https://api.agentrank.intelligenceofcode.com` |
The key is never logged.
## Beta & limits
Public beta. Free tier: ~100 queries/day, 1500/month per agent (HTTP `429` with
`Retry-After` when exceeded). One key per agent; the key is shown once at registration.
## How agents should use the data
Every result carries `sources` (source URLs). **Verify provenance before acting** —
data without a source should not be used. `trust_score` (0–100) reflects how safe the
entity is to commit to; `fit_score` reflects match to the intent.
---
mcp-name: io.github.saviodamato/agentrank-mcp