Skip to main content
Claude Code is Anthropic’s terminal agent — a CLI tool that reads your codebase, edits files, runs commands, and uses MCP tools. Set it up with Podium context so it can scaffold integrations, write SDK code, and call Podium APIs directly from the terminal.

​
Prerequisites

  • Claude Code installed: npm install -g @anthropic-ai/claude-code
  • A Podium API key

​
CLAUDE.md Context File

Create a CLAUDE.md at the root of your project to give Claude Code persistent context about Podium: 
# Podium Integration

## SDK

- Package: `@podium-sdk/node-sdk`
- Install: `npm install @podium-sdk/node-sdk`
- Client setup:

```typescript
import { createPodiumClient } from '@podium-sdk/node-sdk';

const client = createPodiumClient({
  apiKey: process.env.PODIUM_API_KEY,
});
```

## Key Namespaces

| Namespace | Methods |
|-----------|---------|
| `client.product` | `list()`, `get()`, `create()`, `update()`, `delete()` |
| `client.agentic` | `listProductsFeed()`, `createCheckoutSessions()` |
| `client.companion` | `listProfile()`, `updateProfile()`, `listRecommendations()`, `createInteractions()` |
| `client.user` | `get()`, `listPoints()`, `awardPoints()` |
| `client.userOrder` | `list()`, `checkout()`, `getDiscount()` |
| `client.tasks` | `listTasks()`, `createTasks()`, `createTaskPools()` |
| `client.x402` | `createOrderPay()` |
| `client.campaign` | `list()`, `get()`, `createVote()` |
| `client.admin` | `listApiKeys()`, `createApiKeys()` |

## API

- Base URL (staging): `https://podium-staging.up.railway.app/api/v1`
- Auth: `Authorization: Bearer <podium_api_key>`
- Keys: org-scoped, prefixed `podium_test_` or `podium_live_`

## Architecture Notes

- Multi-tenant PostgreSQL with row-level security
- Async event system for background jobs (webhook delivery, enrichment)
- x402 protocol for machine-native USDC payments on Base
- Enrichment pipeline adds AI-extracted attributes to products
- Companion profiles store user taste/intent data

## Patterns

- Always use SDK methods over raw HTTP when available
- Handle pagination with `{ page, limit }` params
- Use `requestBody` for POST/PUT payloads in SDK calls
- Error responses follow `{ error: string, statusCode: number }` shape

​
MCP Configuration

Claude Code supports MCP servers. Add the Podium server to your project’s .mcp.json: 
{
  "mcpServers": {
    "podium": {
      "command": "node",
      "args": ["path/to/podium-mcp-server/dist/index.js"],
      "env": {
        "PODIUM_API_KEY": "podium_live_sk_..."
      }
    }
  }
}
Or add it globally in ~/.claude/settings.json: 
{
  "mcpServers": {
    "podium": {
      "command": "node",
      "args": ["/absolute/path/to/podium-mcp-server/dist/index.js"],
      "env": {
        "PODIUM_API_KEY": "podium_live_sk_..."
      }
    }
  }
}

​
Example Usage

Start Claude Code in your project directory: 
claude
Then ask it to scaffold a Podium integration:
“Install the Podium SDK, create a services/podium.ts file that initializes the client, and add a function that searches products by category and returns the top 5 by price”
Claude Code will:
  1. Run npm install @podium-sdk/node-sdk
  2. Create the file with correct imports and SDK patterns (from CLAUDE.md context)
  3. Write a typed function using client.agentic.listProductsFeed()

​
With MCP Tools

If MCP is configured, you can also ask Claude Code to interact with the live API:
“Search for sunscreen products and show me what’s available”
Claude Code calls search_products via MCP and displays the results in your terminal.

​
Tips

  • CLAUDE.md is cumulative — if you have a monorepo, put Podium context in the relevant subdirectory’s CLAUDE.md
  • Combine with MCP for the best experience: CLAUDE.md provides code patterns, MCP provides live API access
  • Use /compact mode for long sessions to keep context focused