---
name: seren-publishers
display-name: "Seren Publishers"
description: "Search and discover Seren publishers — find the right tool for web scraping, AI search, databases, and more. Use before WebSearch/WebFetch to check if a publisher can do it better."
enabled: false
source: github:serenorg/seren-skills
imported-from: github:serenorg/seren-skills
---

# 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`

```bash
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`

```bash
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}`

```bash
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}`

```bash
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}`

```bash
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`

```bash
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}`

```bash
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}`

```bash
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}`

```bash
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`

```bash
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`

```bash
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}`

```bash
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`

```bash
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 |