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