Integrate with Chance AI

Developer portal

MCP server

Protocol 2025-11-25

The same opportunity catalogue as the REST API — jobs, scholarships, training programmes and tenders — exposed to AI agents through read-only, account-authorized tool calls.

https://mcp.chance.africa/mcp

Read the REST reference

Transport

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

Protocol header

mcp-protocol-version: 2025-11-25

Access

OAuth 2.1 with browser sign-in and explicit read-only consent.

Connect a client

Add the protected endpoint to your client. It will open Chance AI in your browser so you can sign in and approve the mcp:read scope. Tokens are stored and refreshed by the client.

mcpServers configuration

{
  "mcpServers": {
    "chance-ai": {
      "type": "http",
      "url": "https://mcp.chance.africa/mcp"
    }
  }
}

Works with

Use a custom connector or remote MCP server in any supported client.

Claude Code Claude Desktop OpenAI Codex CLI Gemini CLI Cursor Windsurf GitHub Copilot in VS Code

Protocol version

mcp-protocol-version

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

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

Authentication

Your Chance AI account

The MCP endpoint requires OAuth. Your client discovers the authorization server, opens browser sign-in, and asks you to approve access to your Chance AI account.

Tools

Five read-only tools. Call tools/list for the full schemas, including each tool's output shape.

listOpportunities

List opportunities

Search and filter publicly available opportunities across every category.

query object · Optional: Filters include query, type, category, location, province, organOfState, postedFrom, postedTo, page and pageSize.

searchOpportunities

Search opportunities

Rank publicly available opportunities by relevance to a search phrase.

query object · Required: Set query to the search phrase. The same type, category, location, province, organOfState, postedFrom, postedTo, page and pageSize filters apply.

listJobs

List jobs

Search and filter publicly available job opportunities.

query object · Optional: Filters include query, category, location, postedFrom, postedTo, page, limit and pageSize.

getOpportunity

Get an opportunity

Retrieve one publicly available opportunity by identifier.

path object · Required: Set opportunity_id to an identifier returned by listOpportunities or listJobs.

getOpportunityStats

Get opportunity stats

Retrieve public catalogue counts and the next known opportunity deadline.