Integrate with Chance AI

Developer portal

MCP server

Protocol 2025-06-18

The same opportunity catalogue as the REST API — jobs, scholarships, training programmes and tenders — exposed to AI agents as tool calls.

https://api.chance.africa/api/mcp

Get an API key Read the REST reference

Transport

JSON-RPC 2.0 over HTTP POST. Every other method answers 405.

Protocol header

mcp-protocol-version: 2025-06-18

Authentication

The same bearer key as the REST API, in the Authorization header.

Connect a client

Add the server to your MCP client configuration. Replace the placeholder with a key from the API keys page. Well-behaved clients send the protocol version header for you.

mcpServers configuration

{
  "mcpServers": {
    "chance-ai": {
      "type": "http",
      "url": "https://api.chance.africa/api/mcp",
      "headers": {
        "Authorization": "Bearer ca_live_your_key_here"
      }
    }
  }
}

Protocol version

mcp-protocol-version

Optional. Omit it and the server answers on 2025-06-18. Send an unsupported value and the request is rejected with 400.

Supported: 2025-06-182025-03-262024-11-05

Authentication and quotas

Authentication

Send your API key as a bearer token: Authorization: Bearer ca_live_…

Anonymous calls are accepted but limited per IP address. A keyed call draws down the same monthly allowance as the REST API and returns the same X-RateLimit-* headers. Track usage on the API keys page.

Tools

Three read-only tools. Call tools/listfor the full schemas, including each tool's output shape.

search_opportunities

Search opportunities

Free-text search across every category, with optional filters. Use this first to discover opportunity ids.

query string · Optional: Phrase matched against title, description and tags.
type string · Optional: One of job, study, training, tender or other.
location string · Optional: Matched against the published location.
category string · Optional: Sector or category label.
page integer · Optional, defaults to 1: One-based page index, up to 200.
pageSize integer · Optional, defaults to 10: Records per page, between 1 and 25.

get_opportunity

Get an opportunity by id

Fetch a single opportunity with its category-specific details, such as salary, institution or tender closing date.

id string (uuid) · Required: An id returned by search_opportunities or list_jobs.

list_jobs

List job opportunities

A paginated feed of the most recent job listings, newest first. Prefer search_opportunities when the request names a role, employer or place.

page integer · Optional, defaults to 1: One-based page index, up to 200.
limit integer · Optional, defaults to 10: Records per page, between 1 and 25.

Call it directly

No MCP client required. Export your key as CHANCE_API_KEY first.

List the tools

curl -sS -X POST "https://api.chance.africa/api/mcp" \
  -H "Content-Type: application/json" \
  -H "mcp-protocol-version: 2025-06-18" \
  -H "Authorization: Bearer $CHANCE_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Search opportunities

curl -sS -X POST "https://api.chance.africa/api/mcp" \
  -H "Content-Type: application/json" \
  -H "mcp-protocol-version: 2025-06-18" \
  -H "Authorization: Bearer $CHANCE_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_opportunities",
      "arguments": { "query": "renewable energy", "type": "job", "pageSize": 5 }
    }
  }'

{ "mcpServers": { "chance-ai": { "type": "http", "url": "https://api.chance.africa/api/mcp", "headers": { "Authorization": "Bearer ca_live_your_key_here" } } } }

curl -sS -X POST "https://api.chance.africa/api/mcp" \ -H "Content-Type: application/json" \ -H "mcp-protocol-version: 2025-06-18" \ -H "Authorization: Bearer $CHANCE_API_KEY" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "search_opportunities", "arguments": { "query": "renewable energy", "type": "job", "pageSize": 5 } } }'