Skip to main content

MCP server

The Offri API is also available as an MCP server, so AI clients can work with your proposals, clients, and components directly:

https://mcp.offri.app

Most endpoints in this reference are exposed as MCP tools, so almost anything you can do through the API an AI client can do on your behalf.

Connecting

Add the URL above wherever your MCP client configures remote servers. Any client that supports remote MCP servers over streamable HTTP with OAuth will work. No API key or manual setup is needed: when you connect, you log in to Offri, pick which organisation the client may access, and approve the requested scopes. All tool calls are then limited to that organisation and those permissions.

Claude

We still need to publish Offri as a connector for Claude. We will update this documentation once it is available.

ChatGPT

We still need to publish Offri as a connector for ChatGPT. We will update this documentation once it is available.

Claude Code
claude mcp add --transport http offri https://mcp.offri.app

Then, inside Claude Code, run /mcp and select the server to log in.

Because Claude Code runs locally on your computer, we can't verify that the app requesting these permissions actually is Claude Code. An "unverified app" notice while logging in is expected.

Cursor

Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json inside a project):

{
"mcpServers": {
"offri": {
"url": "https://mcp.offri.app"
}
}
}

Because Cursor runs locally on your computer, we can't verify that the app requesting these permissions actually is Cursor. An "unverified app" notice while logging in is expected.

VS Code (GitHub Copilot)

Run MCP: Add Server from the command palette, or add the server to .vscode/mcp.json:

{
"servers": {
"offri": {
"type": "http",
"url": "https://mcp.offri.app"
}
}
}

Because VS Code runs locally on your computer, we can't verify that the app requesting these permissions actually is VS Code. An "unverified app" notice while logging in is expected.

Gemini CLI

Add the server to ~/.gemini/settings.json:

{
"mcpServers": {
"offri": {
"httpUrl": "https://mcp.offri.app"
}
}
}

Because Gemini CLI runs locally on your computer, we can't verify that the app requesting these permissions actually is Gemini CLI. An "unverified app" notice while logging in is expected.

OpenAI Codex CLI

Add the server to ~/.codex/config.toml:

[mcp_servers.offri]
url = "https://mcp.offri.app"

Then log in with:

codex mcp login offri

Because Codex CLI runs locally on your computer, we can't verify that the app requesting these permissions actually is Codex CLI. An "unverified app" notice while logging in is expected.

Cline

Open the MCP Servers panel, then go to Remote Servers → Add server and fill in:

  • Server name: Offri
  • Server URL: https://mcp.offri.app

Because Cline runs locally on your computer, we can't verify that the app requesting these permissions actually is Cline. An "unverified app" notice while logging in is expected.

LM Studio

Go to the Program tab, then Install → Edit mcp.json and add the server (OAuth requires LM Studio 0.4.10 or newer):

{
"mcpServers": {
"offri": {
"url": "https://mcp.offri.app"
}
}
}

Because LM Studio runs locally on your computer, we can't verify that the app requesting these permissions actually is LM Studio. An "unverified app" notice while logging in is expected.