# Sigment for AI agents

URL: https://docs.sigment.ai/

Sigment finds and vets social creators by their real audiences. Claude and other AI agents use it through one MCP server.

Sigment measures who actually engages with Instagram, YouTube and TikTok creators, and how much of that audience the creators share. Any agent that speaks the [Model Context Protocol](https://modelcontextprotocol.io) can drive it: discover creators for a topic, analyze their shared ("core") audience, optimize a selection and save a shareable shortlist.

```txt title="MCP server URL"
https://api.sigment.ai/mcp
```

<Cards>
  <Card title="Quickstart" href="/quickstart" description="Connect Claude and build your first shortlist in two minutes." />
  <Card title="Claude Code" href="/connect/claude-code" description="One command: claude mcp add." />
  <Card title="Tools" href="/tools/account-credits" description="The 24 tools, their inputs and limits." />
  <Card title="Credits" href="/guides/credits-and-max-credits" description="What costs credits and how to cap an agent's spend." />
</Cards>

## How an agent uses Sigment

1. `get_account`: check the workspace, the credit balance and today's agent budget.
2. `discover_creators` (new creators for a topic) or `search_creators` (known handles).
3. `wait_for_job`, then `get_discovery`.
4. `analyze_creators`, then `wait_for_job` and `get_analysis_result`.
5. `create_creator_list` / `set_creator_list`, then `share_creator_list` when the user asks for a link.

Paid tools spend the workspace's credits: discovery costs 20, an analysis 15, and a re-analysis 5. Agents call `quote_cost` first and pass `max_credits`, so a call never spends more than the user allowed.

## What is and isn't available

- **MCP** is the supported way to use Sigment programmatically. Sign in with OAuth (Claude, ChatGPT, Cursor) or use an API key for headless agents.
- **The REST API** behind the app isn't public. It refuses OAuth tokens and API keys with `403`, so build on the MCP tools instead.

<Callout title="Docs for agents">
  Every page is also available as Markdown: add `.mdx` to its URL. [`/llms.txt`](https://docs.sigment.ai/llms.txt) indexes them, and [`/llms-full.txt`](https://docs.sigment.ai/llms-full.txt) has everything in one file. To let Claude Code read these docs as tools, add the docs MCP server: `claude mcp add --transport http sigment-docs https://docs.sigment.ai/mcp`.
</Callout>