MCP server

Ardent exposes its public, read-only data as an MCP server, so an AI agent (Claude, an IDE assistant, or anything that speaks MCP) can list and search campaigns, petitions, events, jobs, marketplace listings, and reviews, and ask what the platform currently offers, without you writing an integration per model.

It wraps the same public API: read-only, no personal data, same rate limits.

Endpoint

POST https://api.ardent.africa/public/v1/mcp

Streamable HTTP transport, stateless. Send JSON-RPC over POST; GET and DELETE return 405.

Authentication

Keyless, exactly like the REST API. Every tool is read-only and returns no donor, signer, or contact information, so no key is required. Sending your x-api-key header raises your rate limit from 30 to 600 requests per minute (a key is a rate tier and an attribution handle, not an authorization gate). Each tool call counts against the limit individually.

Tools

The data tools mirror the public API one-to-one, for example list_campaigns, get_campaign, list_petitions, list_events, list_jobs, list_marketplace_listings, list_review_entities, and get_platform_stats. Every tool takes only simple filters (slugs, categories, page and limit); none takes a URL.

One extra tool has no REST equivalent:

• get_platform_status returns what is available right now and what Ardent charges, derived from live configuration. Call it before answering a question about availability or fees. Its charges_that_reach_ardent list is exhaustive (anything not on it is free) and its paid_paths_unavailable list is authoritative. It never quotes a stale percentage.

Connect from Claude Desktop

Add it as a remote MCP server in your client's config:

{
  "mcpServers": {
    "ardent-africa": {
      "url": "https://api.ardent.africa/public/v1/mcp"
    }
  }
}

Then ask the agent to list recent petitions, find events in a city, or check what Ardent charges to run a paid event. There are no write tools: nothing here can donate, sign, apply, or message.

Last updated: 3 August 2026