@tradeimpression/mcp

Trade Impression MCP server (Workstream E1). Exposes stdio tools so Cursor and other IDE agents can integrate native placements without reading the whole monorepo.

All tools call the Trade Impression serve API at process.env.TI_API_URL ?? http://localhost:8787.

Tools

| Tool | TI API | |------|--------| | ti_get_manifest | GET /v1/integration/manifest | | ti_fetch_placement | GET /v1/placement | | ti_validate_integration | POST /v1/integration/validate | | ti_apply_react | POST /v1/integration/apply/react | | ti_apply_embed | POST /v1/integration/apply/embed | | ti_create_campaign | POST /v1/campaigns | | ti_marketplace_browse | GET /v1/marketplace/directory | | ti_analytics | GET /v1/analytics/* |

Setup

cd I:\IPFoundry\dev-network
pnpm install
pnpm --filter @tradeimpression/mcp build
pnpm dev:serve   # TI API on :8787

Environment

| Variable | Purpose | |----------|---------| | TI_API_URL | Serve API base URL (default http://localhost:8787) | | TI_ADMIN_KEY | Admin key for write routes (ti_create_campaign, apply tools) |

TI_API_URL and TI_ADMIN_KEY are also accepted by the serve API when TI_* vars are unset.

Cursor MCP config

Add to .cursor/mcp.json (or Cursor Settings → MCP):

{
  "mcpServers": {
    "trade-impression": {
      "command": "node",
      "args": [
        "I:/IPFoundry/dev-network/integrations/mcp/dist/index.js"
      ],
      "env": {
        "TI_API_URL": "http://localhost:8787"
      }
    }
  }
}

For development without a build step:

{
  "mcpServers": {
    "trade-impression": {
      "command": "pnpm",
      "args": ["--filter", "@tradeimpression/mcp", "dev"],
      "cwd": "I:/IPFoundry/dev-network"
    }
  }
}

Agent workflow

User: "Add Trade Impression sidebar to settings"
  → ti_get_manifest
  → ti_validate_integration on target file
  → ti_apply_react or ti_apply_embed
  → ti_fetch_placement to verify fill

CLI

pnpm --filter @tradeimpression/mcp build
guild-mcp