> ## Documentation Index
> Fetch the complete documentation index at: https://podium.build/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Tooling

> Connect Podium's commerce, companion, and task APIs to any AI agent, IDE, or framework

Podium is designed to be consumed by agents. Every API endpoint works with bearer-token auth, returns structured JSON, and follows consistent patterns — making it straightforward to expose Podium as tools for any AI system.

This section covers how to integrate Podium with the most popular agent clients, coding assistants, and frameworks.

## MCP Clients

Model Context Protocol (MCP) clients connect to a Podium MCP server you build once and reuse everywhere. See the [Build a Claude MCP Server](/docs/recipes/mcp-server) recipe for the full server implementation.

<CardGroup cols={3}>
  <Card title="Cursor" icon="arrow-pointer" href="/docs/ai-tools/cursor">
    MCP server config and `.cursor/rules` for building on Podium inside Cursor.
  </Card>

  <Card title="Claude Desktop" icon="message-bot" href="/docs/ai-tools/claude-desktop">
    The canonical MCP setup — configure Claude Desktop to search, buy, and manage with Podium tools.
  </Card>

  <Card title="Windsurf" icon="wind" href="/docs/ai-tools/windsurf">
    MCP config and workspace rules for Podium development in Windsurf.
  </Card>
</CardGroup>

## CLI Agents

Terminal-based coding agents that can scaffold Podium integrations, build features, and run SDK code.

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/docs/ai-tools/claude-code">
    CLAUDE.md context file and MCP config for Anthropic's terminal agent.
  </Card>

  <Card title="Codex" icon="robot" href="/docs/ai-tools/codex">
    OpenAI's Codex CLI — instructions file and Podium project scaffolding.
  </Card>
</CardGroup>

## Agent Frameworks

Native tool definitions for building autonomous agents that use Podium as their commerce backend.

<CardGroup cols={3}>
  <Card title="OpenClaw" icon="paw-claws" href="/docs/ai-tools/openclaw">
    Plugin and skill integration for the open-source personal AI assistant.
  </Card>

  <Card title="LangChain" icon="link" href="/docs/ai-tools/langchain">
    DynamicStructuredTool wrappers and LangGraph workflow nodes.
  </Card>

  <Card title="Vercel AI SDK" icon="triangle" href="/docs/ai-tools/vercel-ai">
    Tool definitions with Zod schemas for Next.js streaming AI apps.
  </Card>
</CardGroup>

## Common Pattern

Regardless of which client or framework you use, the integration pattern is the same:

```mermaid theme={null}
graph LR
    Agent["AI Agent / IDE"] -->|"tool call"| Wrapper["Tool Definition"]
    Wrapper -->|"SDK method"| SDK["@podium-sdk/node-sdk"]
    SDK -->|"HTTPS"| API["Podium API"]
    API -->|"JSON response"| SDK
    SDK --> Wrapper
    Wrapper -->|"structured result"| Agent
```

1. **Define tools** that wrap Podium SDK methods
2. **Register them** in your agent client or framework
3. **Provide your API key** via environment variable
4. The agent calls tools through natural conversation or autonomous workflows