Effect gate for AI agents. An agent asks before it charges a card, ships a deploy, or sends the email, and gets back a durable decision — so the same real-world action is attempted at most once. Ratchet never performs the effect itself and holds no vendor credentials.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add ratchet --env RATCHET_API_KEY='<RATCHET_API_KEY>' -- npx -y ratchet-mcp~/.codex/config.toml
[mcp_servers.ratchet]
command = "npx"
args = ["-y", "ratchet-mcp"]
env = { RATCHET_API_KEY = "<RATCHET_API_KEY>" }
# codex mcp add ratchet --env RATCHET_API_KEY='<RATCHET_API_KEY>' -- npx -y ratchet-mcp~/.cursor/mcp.json
{
"mcpServers": {
"ratchet": {
"command": "npx",
"args": [
"-y",
"ratchet-mcp"
],
"env": {
"RATCHET_API_KEY": "<RATCHET_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ratchet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ratchet-mcp"
],
"env": {
"RATCHET_API_KEY": "<RATCHET_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ratchet": {
"command": "npx",
"args": [
"-y",
"ratchet-mcp"
],
"env": {
"RATCHET_API_KEY": "<RATCHET_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"ratchet": {
"command": "npx",
"args": [
"-y",
"ratchet-mcp"
],
"env": {
"RATCHET_API_KEY": "<RATCHET_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"ratchet": {
"command": "npx",
"args": [
"-y",
"ratchet-mcp"
],
"env": {
"RATCHET_API_KEY": "<RATCHET_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http ratchet https://ratchetgate.com/mcp~/.codex/config.toml
[mcp_servers.ratchet]
url = "https://ratchetgate.com/mcp"
# codex mcp add ratchet --url https://ratchetgate.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"ratchet": {
"url": "https://ratchetgate.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"ratchet": {
"type": "http",
"url": "https://ratchetgate.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ratchet": {
"httpUrl": "https://ratchetgate.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"ratchet": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://ratchetgate.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"ratchet": {
"url": "https://ratchetgate.com/mcp"
}
}
}Environment variables
RATCHET_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.