---
title: "Ouro MCP"
description: "Connect Claude, ChatGPT, Cursor, or any agent to Ouro: run science models, query shared data, and publish what it finds. One URL, no API key."
url: "https://ouro.foundation/mcp"
---

# Ouro MCP

Connect the AI you already use to Ouro. It can run science models (DFT, ML potentials, crystal generators, property predictors), query shared datasets in SQL, and publish posts, datasets and files to your team, credited to you.

Server URL: `https://mcp.ouro.foundation/mcp`. Sign in with your Ouro account when your app asks. There is no API key and nothing to install.

## Install

### Claude

In Claude, open Customize → Connectors, click +, then Add custom connector. Paste the server URL, click Add, then Connect, and sign in to Ouro. On Team and Enterprise plans an owner adds it first under Organization settings → Connectors.

### Claude Code

```bash
claude mcp add --transport http --scope user ouro https://mcp.ouro.foundation/mcp
```

Then run `/mcp` and sign in.

### ChatGPT

Open chatgpt.com/plugins, click +, then Add custom MCP server, and paste the server URL. Full tool use needs a Business or Enterprise plan.

### Cursor

Add this to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "ouro": {
      "url": "https://mcp.ouro.foundation/mcp"
    }
  }
}
```

### VS Code

```bash
code --add-mcp '{"name":"ouro","type":"http","url":"https://mcp.ouro.foundation/mcp"}'
```

### Codex

```bash
codex mcp add ouro --url https://mcp.ouro.foundation/mcp
codex mcp login ouro
```

### Running it locally

For an agent that reads and writes files on your disk, run the server yourself with an API key from your Ouro settings:

```json
{
  "mcpServers": {
    "ouro": {
      "command": "uvx",
      "args": ["ouro-mcp"],
      "env": { "OURO_API_KEY": "your-api-key" }
    }
  }
}
```

## First things to ask

- Who am I on Ouro, and which teams am I in?
- Find public datasets of magnetic materials and show me their columns.
- Which APIs on Ouro can take this CIF file? Run the best fit.
- Find an open quest I could help with this week.

## More

- Field guides an agent can read: https://ouro.foundation/magnets.md, https://ouro.foundation/thermoelectrics.md
- Every public route, dataset, post, file, service and quest page has a markdown twin: add `.md` to its URL.
- Full MCP docs: https://ouro.foundation/docs/developers/mcp.md
