Truee MCP Server

Give your AI agent access to verified African business data — instantly.

Endpoint: https://api.usetruee.com/mcp
Transport: HTTP JSON-RPC (MCP 2024-11-05)
Auth: API key via x-api-key header

---

What is Truee?

Truee is a verified business directory for Africa. The Truee MCP server lets AI agents search, filter, and retrieve detailed profiles of verified businesses — with contact info, location, services, branches, and verification status.

---

Quickstart

1. Get an API key

Sign up at usetruee.com and generate an API key from your dashboard.

2. Add to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "truee": {
      "type": "http",
      "url": "https://api.usetruee.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

3. Add to Cursor

Add this to your Cursor MCP settings:

{
  "truee": {
    "type": "http",
    "url": "https://api.usetruee.com/mcp",
    "headers": {
      "x-api-key": "YOUR_API_KEY"
    }
  }
}

---

Tools

search_businesses

Search for businesses using natural language or structured filters. Powered by AI query understanding.

{
  "query": "logistics companies in Lagos",
  "country": "NG",
  "limit": 10
}

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| query | string | Yes | Natural language or keyword search |
| city | string | No | Filter by city |
| state | string | No | Filter by state or region |
| country | string | No | Filter by country (e.g. NG, GH) |
| category | string | No | Category code — use list_categories to see options |
| area | string | No | Neighbourhood or market name (e.g. Victoria Island) |
| lat / lng | number | No | Coordinates for proximity search |
| radius | number | No | Search radius in km (default 50, max 1000) |
| limit | number | No | Results per page (1–50, default 10) |
| page | number | No | Page number (default 1) |

---

query_businesses

Structured search without AI query parsing — faster and cheaper (1 credit vs 2). Use when you already know the exact keywords.

{
  "keywords": "fabric seller",
  "city": "Ibadan",
  "country": "NG"
}

Same parameters as search_businesses, but uses keywords instead of query.

---

get_business

Fetch the full profile of a specific business by its ID or URL slug.

{
  "id_or_slug": "acme-logistics-ng"
}

Returns: services, products, branches, verifications, social links, and all contact info.

---

list_categories

List all available business category codes. Use the returned codes in search_businesses or query_businesses.

{}

No parameters required.

---

Example Prompts

Once connected, you can ask your AI agent things like:

- "Find me verified fintech companies in Lagos"
- "What logistics companies operate in Abuja?"
- "Show me the full profile for acme-logistics-ng"
- "What business categories does Truee cover?"
- "Find fabric sellers near Victoria Island within 10km"

---

Raw JSON-RPC Example

curl -X POST https://api.usetruee.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_businesses",
      "arguments": {
        "query": "fintech companies in Nigeria",
        "limit": 5
      }
    }
  }'

---

Pricing

Each tool call costs credits from your Truee account:

| Tool | Credits |
|------|---------|
| search_businesses | 2 credits |
| query_businesses | 1 credit |
| get_business | 1 credit |
| list_categories | 0 credits |

Get credits at usetruee.com.

---

API Reference

Full API docs: https://api.usetruee.com/mcp/docs

---

Support

- Website: usetruee.com
- Email: support@usetruee.com