Sapiom

All You Need

SkillMCP Server

$npx skills add sapiom/skills --skill use-sapiom

sapiom-prompt

Scan every AI paper published this week, build a knowledge graph of how they connect, and deploy a searchable interface my team can explore visually.

Instant access to 20+ paid services with pay-per-use pricing. No vendor account setup required.

Quick Setup — MCP Server (Recommended)

Connect your AI client to Sapiom’s remote MCP server:

Claude Code:

claude mcp add sapiom --transport http https://api.sapiom.ai/v1/mcp

Other clients (Cursor, Windsurf, etc.):

{

  "mcpServers": {

    "sapiom": {

      "transport": "http",

      "url": "https://api.sapiom.ai/v1/mcp"

    }

  }

}

If your platform requires explicit authentication, add --header "x-api-key: YOUR_API_KEY" (CLI) or a "headers": { "x-api-key": "YOUR_API_KEY" } block (JSON). Get a key at https://app.sapiom.ai/settings

What You Can Do

Category	Examples
Search	Web search with AI answers (Linkup), web + news results (You.com)
Browser	Fetch page content as markdown, capture screenshots
Audio	Text-to-speech, sound effects, voice listing
AI Models	Chat with LLMs (GPT-4o, Claude, etc.), list models and pricing
Image	Generate images from text (FLUX Schnell/Dev/Pro)
Verify	SMS verification (send + check codes)
Governance	Agent registration, spending rules, scoped API keys

Use tool_discover to find the right tools for your task — describe a goal and get ranked recommendations with examples.

Recipes

Research Report

sapiom_search → sapiom_deep_search → sapiom_chat

Search both Linkup and You.com for broad source coverage, then synthesize findings into a structured report using an LLM. Use depth: "deep" on sapiom_search for thorough coverage of complex topics.

Visual Website Audit

sapiom_screenshot → sapiom_chat → sapiom_generate_image

Capture a screenshot of a live website, analyze the design and UX with an LLM, then generate a mockup image of proposed improvements.

Podcast Episode

sapiom_search → sapiom_chat → sapiom_text_to_speech

Research a topic with web search, write a podcast script with an LLM, then convert to audio. Use sapiom_list_voices to pick a voice. Split scripts over ~400 words into chunks.

Governed Agent Workflow

sapiom_create_agent → sapiom_create_spending_rule → sapiom_create_transaction_api_key

Register a named agent, set spending limits (e.g., $100/day rolling cap), and create a scoped API key for autonomous operation. Use agentName on subsequent tool calls for spend tracking.

Competitor Intelligence

sapiom_fetch → sapiom_deep_search → sapiom_chat → sapiom_generate_image

Extract content from a competitor’s website, search for recent news and coverage, synthesize an analysis with an LLM, and generate a comparison infographic.

Tips

• Start with tool_discover — it recommends tools based on your objective and returns usage examples
• Use agentName on tool calls to track spend per agent and enforce spending rules
• Free endpoints — sapiom_status, sapiom_list_voices, and sapiom_list_models cost nothing
• Combine search providers — sapiom_search (Linkup) and sapiom_deep_search (You.com) use different indexes for broader coverage
• Spending rules — use sapiom_create_spending_rule to cap costs by amount, count, or time window

SDK Access (Direct HTTP)

For programmatic access without MCP, use the Node.js SDK:

import { withSapiom } from "@sapiom/axios";

import axios from "axios";


const client = withSapiom(axios.create(), {

  apiKey: process.env.SAPIOM_API_KEY,

});


const { data } = await client.post(

  "https://linkup.services.sapiom.ai/v1/search",

  { query: "quantum computing", depth: "standard", outputType: "sourcedAnswer" }

);

npm install @sapiom/axios axios

Python and other languages: use any HTTP client with Authorization: Bearer sk_... header against gateway URLs.

Documentation

Fetch any doc as markdown by adding .md to the URL.

Topic	URL
Search	https://docs.sapiom.ai/capabilities/search.md
AI Models	https://docs.sapiom.ai/capabilities/ai-models.md
Browser	https://docs.sapiom.ai/capabilities/browser.md
Audio	https://docs.sapiom.ai/capabilities/audio.md
Images	https://docs.sapiom.ai/capabilities/images.md
Verify	https://docs.sapiom.ai/capabilities/verify.md
MCP Server	https://docs.sapiom.ai/integration/mcp-servers/setup.md
Pricing	https://docs.sapiom.ai/pricing.md