affset MCP Server
by affsetio.github.affset/mcpv0.4.0
Run affset from chat: stats, campaigns, zones, payouts, targeting, and team.
context tax
queued
security
queued
cold start
queued
freshness
Active26d ago
Install affset MCP server
Install in Claude Code
claude mcp add affset -e AFFSET_BASE_URL='<affset-base-url>' -e AFFSET_API_KEY='<affset-api-key>' -e AFFSET_NAMESPACE='<affset-namespace>' -- npx -y @affset/mcpInstall in Cursor
{
"mcpServers": {
"affset": {
"command": "npx",
"args": [
"-y",
"@affset/mcp"
],
"env": {
"AFFSET_BASE_URL": "<affset-base-url>",
"AFFSET_API_KEY": "<affset-api-key>",
"AFFSET_NAMESPACE": "<affset-namespace>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"affset": {
"command": "npx",
"args": [
"-y",
"@affset/mcp"
],
"env": {
"AFFSET_BASE_URL": "<affset-base-url>",
"AFFSET_API_KEY": "<affset-api-key>",
"AFFSET_NAMESPACE": "<affset-namespace>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"affset": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@affset/mcp"
],
"env": {
"AFFSET_BASE_URL": "<affset-base-url>",
"AFFSET_API_KEY": "<affset-api-key>",
"AFFSET_NAMESPACE": "<affset-namespace>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"affset": {
"command": "npx",
"args": [
"-y",
"@affset/mcp"
],
"env": {
"AFFSET_BASE_URL": "<affset-base-url>",
"AFFSET_API_KEY": "<affset-api-key>",
"AFFSET_NAMESPACE": "<affset-namespace>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| AFFSET_BASE_URL | yes | — | Origin of your affset ad server API (no path, query, or embedded credentials). |
| AFFSET_API_KEY | yes | yes | Tenant API key (Bearer token). Its namespace must match AFFSET_NAMESPACE. |
| AFFSET_NAMESPACE | yes | — | Tenant namespace this key belongs to (lowercase letters, numbers, hyphens; 3–63 chars). |
| AFFSET_REQUEST_TIMEOUT_MS | — | — | Optional per-request HTTP timeout in milliseconds (1000–300000). |
| AFFSET_READ_ONLY | — | — | Optional. Set to true to register only read-only tools (no create/update/delete/cut). |
Remote endpoints
- streamable-http
https://mcp.affset.com/mcp
Freshness
Active — last maintenance signal 26d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-13 · 26d ago · GitHub
Latest release
2026-08-25 · 45d ago · GitHub · 0.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-13 · 26d ago · official registry · v0.4.0
FAQ
›How do I install the affset MCP server in Claude Code?
Run: claude mcp add affset -e AFFSET_BASE_URL='<affset-base-url>' -e AFFSET_API_KEY='<affset-api-key>' -e AFFSET_NAMESPACE='<affset-namespace>' -- npx -y @affset/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does affset require an API key?
Yes. It expects AFFSET_BASE_URL, AFFSET_API_KEY, AFFSET_NAMESPACE, of which 1 is a secret.
›Can I use affset as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is affset in the official MCP registry?
Yes, as io.github.affset/mcp.