> ## 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.

# World Republic MCP server

> Read-only access to the World Republic for AI assistants.

The World Republic MCP server lets an AI assistant such as Claude or ChatGPT read the World Republic's parties, test elections and docs. It needs no sign-in and no key, and it cannot vote, verify you or change anything.

```text theme={null}
https://www.worldrepublic.org/api/mcp
```

## Add the server

| Assistant | How to add it |
| :- | :- |
| Claude | [Open it in Claude's directory](https://claude.ai/directory/connectors/world-republic) and select **Add**, then **Connect** beside its connector if it isn't connected yet. |
| ChatGPT | At [chatgpt.com/plugins](https://chatgpt.com/plugins), click **+** > **Add custom MCP server**, enter the address with no authentication, and select **Create as a plugin**. Then type **@** in a chat and select World Republic. |
| Cursor | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=world-republic\&config=eyJ1cmwiOiJodHRwczovL3d3dy53b3JsZHJlcHVibGljLm9yZy9hcGkvbWNwIn0%3D) |
| VS Code | [Add to VS Code](https://vscode.dev/redirect/mcp/install?name=world-republic\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.worldrepublic.org%2Fapi%2Fmcp%22%7D) |
| Anything else | Add a remote MCP server with the address above. |

From a terminal:

```bash Claude Code theme={null}
claude mcp add --transport http world-republic https://www.worldrepublic.org/api/mcp
```

```bash Codex theme={null}
codex mcp add world-republic --url https://www.worldrepublic.org/api/mcp
```

## Try it

* "Who won the last World Republic test election?"
* "Find World Republic parties about education and tell me what they stand for."
* "Which World Republic parties have been allocated the most subsidies, and how are subsidies decided?"

## What it reads

* **Parties.** The registry, newest first, by search, or ranked by votes or subsidies, and each party's profile, record in closed test elections and subsidies allocated.
* **Test elections.** Every election and its status, and each party's votes and seats once it has closed; while it is open, only the total number of ballots is published.
* **Citizen and party counts.** How many verified citizens and parties there are.
* **These docs.** It searches them and reads whole pages, so it can explain verification, voting, seats, party subsidies and WDD, and link the page it used.

Party names and descriptions are written by party leaders, not by us, and can say anything, including instructions aimed at your assistant. 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.

## Troubleshooting

* **Claude doesn't use it.** Turn it on in the chat: click **+**, select **Plugins**, and turn on World Republic.

## What happens to what you ask?

What the server reads goes to the company that runs your assistant, under that company's privacy policy, as section 6 of the [Privacy Policy](https://docs.worldrepublic.org/legal/privacy) says. To search these docs, the server passes the search's wording to the service that hosts them, with email addresses, phone numbers, wallet addresses and ids removed. The server doesn't sign you in, so it has nothing from your account to pass on.

## Questions or problems

Email [info@worldrepublic.org](mailto:info@worldrepublic.org), or [security@worldrepublic.org](mailto:security@worldrepublic.org) for a security problem.


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