SerenAI

 Pay Per Call Agentic Commerce

Seren MCP Tools Reference

67 tools across 15 categories for managing databases and querying the agent marketplace.

Install · tools.json · mcp/llms.txt

Jump to: Marketplace (8) · Publishers (4) · MCP Publishers (4) · Templates (3) · Payments (4) · Wallet (3) · Projects (5) · Databases (5) · Branches (8) · SQL (3) · Schema (2) · Endpoints (8) · Roles (5) · Connection (1) · Organizations (4)

Marketplace (8 tools)

list_agent_publishers

List active publishers in the agent store

Parameters:
search: string (optional)
is_verified: boolean (optional)
limit: integer (optional)
offset: integer (optional)

get_agent_publisher

Get details about a specific publisher including pricing info by slug

Parameters:
slug: string (required)

suggest_for_task

Get publisher and agent recommendations for a task

Parameters:
query: string (required) - The task to find publishers for
type: string (optional) - publisher, agent, or both
limit: integer (optional)

execute_paid_query

Execute a paid SQL query against a publisher's database

Parameters:
publisher: string (required) - Publisher slug or UUID
query: string (required)
database: string (optional)
confirm: boolean (optional)

execute_paid_api

Execute a paid API request against a publisher's endpoint

Parameters:
publisher: string (required)
method: string (optional)
path: string (optional)
body: object (optional)
confirm: boolean (optional)

execute_paid_api_stream

Execute a paid streaming API request against a publisher's endpoint

Parameters:
publisher: string (required)
method: string (optional)
path: string (optional)
body: object (optional)
confirm: boolean (optional)

estimate_query_cost

Estimate the cost of a SQL query without executing it

Parameters:
publisher: string (required)
query: string (required)

get_supported

Get supported payment protocols and configuration

Publishers (4 tools)

create_publisher

Create a new publisher in the agent store. Publishers can be databases, API integrations, or compute resources.

Parameters:
name: string (required) - Publisher display name
slug: string (required) - URL-friendly slug
wallet_address: string (required) - Wallet address for payments
wallet_network_id: string (required) - Network ID (CAIP-2 format)
publisher_category: string (required) - Category: database, integration, or compute
database_type: string (optional) - For database category: serendb, neon, or supabase
integration_type: string (optional) - For integration category: api or mcp
compute_type: string (optional) - For compute category: template, workflow, or function
api_url: string (optional) - External API URL (for integration_type: api)
mcp_endpoint: string (optional) - MCP server endpoint URL (for integration_type: mcp)
description: string (optional) - Publisher description
email: string (optional) - Contact email

update_publisher

Update an existing publisher's details including taxonomy, endpoints, and MCP configuration.

Parameters:
slug: string (required) - Publisher slug to update
name: string (optional) - Publisher display name
description: string (optional) - Publisher description
resource_name: string (optional) - Resource display name for marketplace
resource_description: string (optional) - Resource description for marketplace
api_url: string (optional) - External API URL (for API publishers)
mcp_endpoint: string (optional) - MCP server endpoint URL (for MCP publishers)
email: string (optional) - Contact email
is_active: boolean (optional) - Whether the publisher is active

update_publisher_pricing

Update a publisher's pricing configuration

Parameters:
slug: string (required)
price_per_call: string (optional) - Price per API call (decimal string)
base_price_per_1000_rows: string (optional)
min_charge: string (optional)
max_charge: string (optional)

upload_publisher_logo

Upload a logo image for a publisher

Parameters:
slug: string (required)
logo: string (required) - Base64 encoded image
content_type: string (required) - image/png, image/jpeg, etc.

MCP Publishers (4 tools)

list_mcp_tools

List tools available on an MCP publisher. Use this to discover what capabilities an MCP publisher provides.

Parameters:
publisher: string (required) - Publisher slug of the MCP publisher

call_mcp_tool

Call a tool on an MCP publisher. Use list_mcp_tools first to see available tools and their input schemas.

Parameters:
publisher: string (required) - Publisher slug of the MCP publisher
tool_name: string (required) - Name of the tool to call
arguments: object (optional) - Arguments to pass to the tool (JSON object)

list_mcp_resources

List resources available on an MCP publisher. MCP publishers can expose resources (like files, data sources) that can be read.

Parameters:
publisher: string (required) - Publisher slug of the MCP publisher

read_mcp_resource

Read a resource from an MCP publisher. Use list_mcp_resources first to see available resources and their URIs.

Parameters:
publisher: string (required) - Publisher slug of the MCP publisher
uri: string (required) - URI of the resource to read

Templates (3 tools)

list_agent_templates

List available agent templates in the catalog

Parameters:
search: string (optional)
language: string (optional) - python, typescript, rust
limit: integer (optional)
offset: integer (optional)

get_agent_template

Get details about a specific agent template by slug

Parameters:
slug: string (required)

invoke_agent_template

Invoke an agent template with input data

Parameters:
slug: string (required)
input: object (required) - Input data for the template
confirm: boolean (optional)

Payments (4 tools)

get_prepaid_balance

Get your SerenBucks balance

get_transaction_history

Get transaction history (deposits, charges, refunds)

Parameters:
limit: integer (optional)
offset: integer (optional)

create_prepaid_deposit

Deposit SerenBucks with a credit card via Stripe

Parameters:
amount_usd: number (required) - Amount in USD (minimum $5.00)

get_x402_deposit_requirements

Get x402 on-chain deposit requirements for depositing USDC

Parameters:
publisher: string (required)
amount: string (required) - Amount to deposit (decimal string)
agent_wallet: string (required) - Agent wallet address

Wallet (3 tools)

get_wallet_status

Get complete wallet status including SerenBucks and on-chain USDC balance

has_local_wallet

Check if a local wallet is configured

get_local_wallet_address

Get the local wallet address (requires WALLET_PRIVATE_KEY)

Projects (5 tools)

list_projects

List all Seren projects accessible to the authenticated user

create_project

Create a new Seren project

Parameters:
name: string (required) - Project name
region: string (required) - Deployment region

describe_project

Get detailed information about a specific project

Parameters:
project_id: string (required)

update_project

Update a project's settings including name, security options, and compute defaults

Parameters:
project_id: string (required)
name: string (optional) - New project name
compute_unit_min: integer (optional)
compute_unit_max: integer (optional)

delete_project

Delete a Seren project

Parameters:
project_id: string (required)

Databases (5 tools)

list_all_databases

List all databases across all projects with project and branch names

list_databases

List all databases in a branch

Parameters:
project_id: string (required)
branch_id: string (required)

get_database

Get details about a specific database

Parameters:
project_id: string (required)
branch_id: string (required)
database_id: string (required)

create_database

Create a new database in a branch

Parameters:
project_id: string (required)
branch_id: string (required)
name: string (required)

delete_database

Delete a database from a branch

Parameters:
project_id: string (required)
branch_id: string (required)
database_id: string (required)

Branches (8 tools)

list_branches

List branches for a project

Parameters:
project_id: string (required)

create_branch

Create a new branch in a project

Parameters:
project_id: string (required)
name: string (required)
parent_branch_id: string (optional)

describe_branch

Get details about a specific branch

Parameters:
project_id: string (required)
branch_id: string (required)

rename_branch

Rename a branch

Parameters:
project_id: string (required)
branch_id: string (required)
name: string (required) - New branch name

reset_branch

Reset a branch to its parent's latest state (destroys all data on the branch)

Parameters:
project_id: string (required)
branch_id: string (required)

set_branch_expiration

Set or remove branch expiration date

Parameters:
project_id: string (required)
branch_id: string (required)
expires_at: string (optional) - Expiration date in RFC3339 format, or null to remove

set_default_branch

Set a branch as the default branch for the project

Parameters:
project_id: string (required)
branch_id: string (required)

delete_branch

Delete a branch

Parameters:
project_id: string (required)
branch_id: string (required)

SQL (3 tools)

run_sql

Execute a SQL query against a database

Parameters:
project_id: string (required)
branch_id: string (required)
database: string (required)
query: string (required)

run_sql_transaction

Execute multiple SQL statements in a single transaction

Parameters:
project_id: string (required)
branch_id: string (required)
database: string (required)
queries: array (required)

explain_sql_statement

Explain a SQL statement (FORMAT JSON)

Parameters:
project_id: string (required)
branch_id: string (required)
database: string (required)
query: string (required)

Schema (2 tools)

get_database_tables

List tables in a database schema

Parameters:
project_id: string (required)
branch_id: string (required)
database: string (required)
schema: string (optional)

describe_table_schema

Get schema information for a table

Parameters:
project_id: string (required)
branch_id: string (required)
database: string (required)
table_name: string (required)
schema: string (optional)

Endpoints (8 tools)

list_endpoints

List all endpoints for a branch

Parameters:
project_id: string (required)
branch_id: string (required)

create_endpoint

Create a new endpoint for a branch

Parameters:
project_id: string (required)
branch_id: string (required)
autoscaling_min: integer (optional)
autoscaling_max: integer (optional)

get_endpoint_status

Get the current status of an endpoint (running, suspended, etc.)

Parameters:
project_id: string (required)
branch_id: string (required)
endpoint_id: string (required)

update_endpoint

Update an endpoint's settings including autoscaling and suspend timeout

Parameters:
project_id: string (required)
branch_id: string (required)
endpoint_id: string (required)
autoscaling_min: integer (optional)
autoscaling_max: integer (optional)
suspend_timeout_seconds: integer (optional)

start_endpoint

Start a suspended endpoint

Parameters:
project_id: string (required)
branch_id: string (required)
endpoint_id: string (required)

suspend_endpoint

Suspend an endpoint

Parameters:
project_id: string (required)
branch_id: string (required)
endpoint_id: string (required)

restart_endpoint

Restart an endpoint (rolling restart via Kubernetes)

Parameters:
project_id: string (required)
endpoint_id: string (required)

delete_endpoint

Delete an endpoint

Parameters:
project_id: string (required)
branch_id: string (required)
endpoint_id: string (required)

Roles (5 tools)

list_roles

List all roles in a branch

Parameters:
project_id: string (required)
branch_id: string (required)

create_role

Create a new database role on a branch

Parameters:
project_id: string (required)
branch_id: string (required)
name: string (required) - Role name

reset_role_password

Reset a database role's password, generating a new secure password

Parameters:
project_id: string (required)
branch_id: string (required)
role_id: string (required)
password: string (required) - New password for the role

reveal_role_password

Reveal the current password for a database role

Parameters:
project_id: string (required)
branch_id: string (required)
role_name: string (required)

delete_role

Delete a database role from a branch

Parameters:
project_id: string (required)
branch_id: string (required)
role_id: string (required)

Connection (1 tools)

get_connection_string

Get connection string for a branch

Parameters:
project_id: string (required)
branch_id: string (required)
database: string (optional)
pooled: boolean (optional) - Return pooled connection
role: string (optional) - PostgreSQL role/username

Organizations (4 tools)

list_organizations

List organizations accessible to the authenticated user

list_api_keys

List all API keys for an organization

Parameters:
organization_id: string (required)

create_api_key

Create a new API key for an organization

Parameters:
organization_id: string (required)
name: string (required)
expires_in_days: integer (optional)

revoke_api_key

Revoke an API key

Parameters:
organization_id: string (required)
key_id: string (required)

Authentication

The MCP server supports three authentication modes:

Read-Only Mode

Set READ_ONLY=true to block write operations (useful for shared deployments).