> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worldrepublic.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Two ways to read the World Republic's parties and test elections from outside the app.

The World Republic's party registry, test elections and their results can be read from outside the app: by an AI assistant through the MCP server, or by your own code through the API. Both are free, need no account and no key, and only read.

```bash Request theme={null}
curl https://www.worldrepublic.org/api/v1/stats
```

```json Response theme={null}
{
  "verifiedCitizens": 20000,
  "parties": {
    "listed": 1800,
    "includingUnlisted": 2000
  }
}
```

## Which one do I need?

| | MCP server | API |
| :- | :- | :- |
| **For** | AI assistants such as Claude and ChatGPT | Your app, site or script, or an AI coding tool writing it |
| **Address** | `https://www.worldrepublic.org/api/mcp` | `https://www.worldrepublic.org/api/v1` |
| **Sign-in** | None | None |
| **Reads** | Parties and their subsidies, test elections and results, citizen and party counts, and these docs | Parties and their subsidies, test elections and results, and citizen and party counts |
| **Reference** | Built into the server | [OpenAPI document](https://www.worldrepublic.org/api/v1/openapi.json) |
| **Guide** | [MCP server](https://docs.worldrepublic.org/integrations/mcp-server.md) | [API reference](https://docs.worldrepublic.org/integrations/api-reference.md) |

## What can't they do?

Both read only public information. Voting, verification, giving consent, registering or editing a party, and anything to do with your account happen only in the app at [worldrepublic.org](https://worldrepublic.org). Test elections are experimental and non-binding: a test election is not a public election, and it confers no public office, mandate or authority on anyone.

## What happens to what is read?

Everything they read is already public in the app. When an AI assistant reads it for you, the company that runs the assistant receives it, under its own privacy policy, as section 6 of the [Privacy Policy](https://docs.worldrepublic.org/legal/privacy) says.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.