serenorg/seren-publishers

Seren Publishers

For Claude: How to Use This Skill

Skill instructions are preloaded in context when this skill is active. Do not perform filesystem searches or tool-driven exploration to rediscover them; use the guidance below directly.

Use this skill when a user wants to discover, evaluate, or call publishers from the Seren marketplace.

API

Use this skill alongside the core Seren API skill (https://api.serendb.com/skill.md).

Base Route

All routes go through https://api.serendb.com/publishers.

Authentication

All endpoints require Authorization: Bearer $SEREN_API_KEY.

When to Use

• Before using WebSearch or WebFetch — a publisher may do the job better
• Before saying "I cannot do X" — check if a publisher can help
• When the user asks to find a tool or service for a task
• When comparing publisher pricing or capabilities

Discovery

Find a publisher for a specific task using natural language.

GET /publishers/suggest

curl -sS -X GET "https://api.serendb.com/publishers/suggest?query=scrape+website" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Returns ranked suggestions with match_reason and score. Always try this first.

List all available publishers.

GET /publishers

curl -sS -X GET "https://api.serendb.com/publishers" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Search publishers by name or keyword.

GET /publishers?search={term}

curl -sS -X GET "https://api.serendb.com/publishers?search=firecrawl" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Filter publishers by category.

GET /publishers?category={category}

curl -sS -X GET "https://api.serendb.com/publishers?category=database" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Categories: database, integration, compute.

Get full details for a specific publisher including pricing and capabilities.

GET /publishers/{slug}

curl -sS -X GET "https://api.serendb.com/publishers/firecrawl-serenai" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Get a publisher's logo.

GET /publishers/{slug}/logo

curl -sS -X GET "https://api.serendb.com/publishers/firecrawl-serenai/logo"

Calling Publishers

Execute a request against a publisher's root endpoint (e.g., database queries).

POST /publishers/{slug}

curl -sS -X POST "https://api.serendb.com/publishers/my-database" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

Proxy a GET request to a publisher's sub-path.

GET /publishers/{slug}/{path}

curl -sS -X GET "https://api.serendb.com/publishers/firecrawl-serenai/scrape?url=https://example.com" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Proxy a POST request to a publisher's sub-path.

POST /publishers/{slug}/{path}

curl -sS -X POST "https://api.serendb.com/publishers/firecrawl-serenai/scrape" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Estimate query cost before execution.

POST /publishers/{slug}/estimate

curl -sS -X POST "https://api.serendb.com/publishers/my-database/estimate" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users"}'

MCP Access

List tools exposed by an MCP publisher.

GET /publishers/{slug}/_tools

curl -sS -X GET "https://api.serendb.com/publishers/my-mcp-publisher/_tools" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Call an MCP tool by name.

POST /publishers/{slug}/{tool_name}

curl -sS -X POST "https://api.serendb.com/publishers/my-mcp-publisher/tool_name" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"param":"value"}'

List resources exposed by an MCP publisher.

GET /publishers/{slug}/_resources

curl -sS -X GET "https://api.serendb.com/publishers/my-mcp-publisher/_resources" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Pricing

Publishers use different billing models:

• PerRequest -- flat fee per API call
• PerByte -- cost based on response size (common for databases)
• Free -- no cost (e.g., some community publishers)

Check pricing via GET /publishers/{slug} before calling. If you get HTTP 402, top up SerenBucks via GET /wallet/balance.

Publisher Categories

| Category | Examples | Use For | |----------|----------|---------| | Integration | Firecrawl, Perplexity | Web scraping, AI search, APIs | | Database | SerenDB, Neon | SQL queries, data access | | Compute | Seren Cloud | Running hosted agents |