---
name: syntalic-mcp-setup
description: "Install, configure and fund the Syntalic MCP server in Claude Code, Cursor, Codex or any MCP client, then make the first paid calls for CPG prices, promotions, assortment, stock and social data. Use when an agent needs to set up Syntalic, fund its wallet, or choose which measure tool answers a question."
---

# Syntalic: set up the MCP server

CPG data analytics for agents. Multi-channel pricing & promo, and social media insights. One-time setup, then pay per call in USDC. No API key.

## Install

Needs Node.js 20 or later. The server runs locally over stdio.

```bash
npx -y @syntalic/mcp-server@latest --setup
```

Setup does two things:

1. Generates a wallet for Solana and EVM (Base and Tempo), or skips that if you bring your own keys (below).
2. Adds the server to Claude Code.

Pass `--yes` to take every default, or `--no-claude` to skip Claude Code.

Then fund the wallet with USDC on Solana or Base, or USDC.e on Tempo. Calls cost $0.01 to $0.05, so a few dollars buys hundreds of calls. Use a dedicated agent wallet with a small balance, not your main one.

```bash
# Back up the generated wallet before funding; run it privately, never in logs
npx @syntalic/mcp-server@latest --export-keys

# Wallet addresses, balances and config
npx @syntalic/mcp-server@latest --info
```

## Keep it on the newest release

Setup registers `npx -y @syntalic/mcp-server@latest`, so every start runs the newest release. A server set up before 0.14.0 was registered without `@latest`, and npx can keep running an older cached release. To fix one, register it again:

```bash
claude mcp remove -s user syntalic
claude mcp add -s user syntalic -- npx -y @syntalic/mcp-server@latest
```

## Other clients

Claude Code reads MCP servers from `claude mcp add` (what setup runs), not from `~/.claude/settings.json`.

For Cursor (`~/.cursor/mcp.json`), Windsurf (`~/.codeium/windsurf/mcp_config.json`) or any other client that takes an `mcpServers` file:

```json
{
  "mcpServers": {
    "syntalic": {
      "command": "npx",
      "args": ["-y", "@syntalic/mcp-server@latest"]
    }
  }
}
```

For VS Code, add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "syntalic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@syntalic/mcp-server@latest"]
    }
  }
}
```

For Codex, add to `~/.codex/config.toml`:

```toml
[mcp_servers.syntalic]
command = "npx"
args = ["-y", "@syntalic/mcp-server@latest"]
```

## Bring your own keys

Export both keys, then run setup. It sees them, creates no wallet file, and only adds the server to Claude Code.

```bash
export SYNTALIC_EVM_PRIVATE_KEY=0x<your_evm_private_key>      # pays on Base and Tempo
export SYNTALIC_SOLANA_PRIVATE_KEY=<your_solana_base58_key>
npx @syntalic/mcp-server@latest --setup
```

Both are required together: the server refuses to start with only one. With both set, `~/.syntalic/wallet.json` is ignored, and `--info` shows the addresses the keys pay from. The MCP client must pass both variables to the server too: an `"env": { ... }` block in JSON configs, or a `[mcp_servers.syntalic.env]` table in Codex's TOML.

## CLI commands

Run them as `npx @syntalic/mcp-server@latest <command>`. A person runs `--export-keys` in their own terminal, never an agent: it prints the private keys.

| Command | Purpose |
| - | - |
| `--setup` | Wallet and Claude Code setup. `--yes` takes every default; `--no-claude` skips Claude Code |
| `--export-keys` | Print the private keys for backup |
| `--info` | Wallet addresses, balances and config, no keys shown |
| `--help` | Usage |

## First calls

The server offers 17 tools: six free discovery tools (catalog overview, coverage map, list retailers, list brands, browse categories, wallet info) and eleven paid measure tools, one per measure.

1. `measure_resolve` a name ("soda", "poppi") to ids, once per conversation.
2. Pass the ids as `subject` to a measure: `measure_prices`, `measure_assortment`, `measure_attention`, `measure_scout` and so on.

- measure_offers ($0.01): Who sells one product, and at what price, now
- measure_prices ($0.02): The price level and spread of a shelf
- measure_trend ($0.02): How prices moved, for a product, a shelf or a brand
- measure_promotions ($0.01): Who discounts, how often and how deep
- measure_assortment ($0.02): What is on the shelf, and who holds it
- measure_attention ($0.03): Share of social conversation, and how it is moving
- measure_signals ($0.03): What posts say, as labels: launches, reviews, stance, names, practices
- measure_scout ($0.05): Social attention set against the shelf
- measure_resolve ($0.01): A name, phrase or code to ids
- measure_neighbors ($0.01): What sits next to an id
- measure_coverage ($0.01): How much evidence stands behind an id

## How payment works

1. A tool calls a paid route.
2. The API answers `402 Payment Required` with the price.
3. The wallet signs the USDC payment and the call is sent again.
4. The answer comes back. With x402 (Solana or Base) the payment is captured only for an answer, so a 404 costs nothing. MPP on Tempo settles up front.

No API key, no subscription. Docs: https://syntalic.com/docs/integrate/mcp
