crewai-surgemesh

Guide: CrewAI on surgemesh.com

CrewAI tools for Surgemesh, agent-first social publishing. Give a crew the ability to quote the exact price of a post, schedule it to one or more social channels, check prepaid credit, and track delivery.

Preview: quotes, channel connects and sandbox posts work today. Sandbox posts are validated against each network's real limits and priced exactly, but never published or charged. Live posting and payments are coming soon.

Install

pip install crewai-surgemesh

Get an API key

curl -X POST https://api.surgemesh.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"email": "you@example.com", "accept_terms": true}'
export SURGEMESH_API_KEY=sm_...   # from the response, shown once

Quick start

from crewai import Agent, Crew, Task
from crewai_surgemesh import surgemesh_tools

social = Agent(
    role="Social media manager",
    goal="Schedule approved posts at a good price",
    backstory="You quote before you post and never exceed the quoted price.",
    tools=surgemesh_tools(),            # reads SURGEMESH_API_KEY
)

task = Task(
    description="Quote a post for 2026-11-03T15:00:00Z, then schedule 'Hello from our crew' "
                "to my sandbox channel at that time. Report the price and post id.",
    expected_output="Price, post id and status.",
    agent=social,
)

Crew(agents=[social], tasks=[task]).kickoff()

Tools

surgemesh_tools() returns all five sharing one client, so publish_post can use a quote_id from quote_post. The classes (SurgemeshQuotePostTool, SurgemeshPublishPostTool, SurgemeshListChannelsTool, SurgemeshGetBalanceTool, SurgemeshGetPostStatusTool) can also be used one at a time.

Safety rules built in

• Nothing posts on its own. The tools act only when an agent calls them.
• Quote first. publish_post refuses to run without a quote_id or an explicit idempotency_key. With a quote_id, the quoted price becomes the price cap (max_price_usd), so the post is refused rather than charged more.
• Exactly once. Every publish carries an idempotency key, so a retry never double-posts or double-charges.
• Clear credit errors. If the account lacks prepaid credit, the tool returns a plain message (nothing scheduled or charged) pointing to cheaper times or adding credit.

For a human sign-off before publishing, give the publishing task human_input=True.

Configuration

tools = surgemesh_tools(api_key="sm_...", base_url="https://api.surgemesh.com")

Zero-code alternative: the Surgemesh MCP server

Surgemesh is also a remote MCP server (com.surgemesh/surgemesh in the MCP Registry) with the full tool set, including channel connect, onboarding and analytics.

With CrewAI's built-in MCP support:

import os
from crewai import Agent
from crewai.mcp import MCPServerHTTP

agent = Agent(
    role="Social media manager",
    goal="Schedule approved posts",
    backstory="...",
    mcps=[MCPServerHTTP(
        url="https://api.surgemesh.com/mcp",
        headers={"Authorization": f"Bearer {os.environ['SURGEMESH_API_KEY']}"},
    )],
)

Or with MCPServerAdapter from crewai-tools[mcp]:

import os
from crewai_tools import MCPServerAdapter

params = {
    "url": "https://api.surgemesh.com/mcp",
    "transport": "streamable-http",
    "headers": {"Authorization": f"Bearer {os.environ['SURGEMESH_API_KEY']}"},
}
with MCPServerAdapter(params) as tools:
    agent = Agent(role="...", goal="...", backstory="...", tools=tools)

Links

• Website: https://surgemesh.com
• API reference (OpenAPI): https://api.surgemesh.com/openapi.json
• Agent guide: https://surgemesh.com/agents
• Terms: https://surgemesh.com/terms · Privacy: https://surgemesh.com/privacy

License

Apache License 2.0. Copyright 2026 Novus Index, LLC. See LICENSE and NOTICE. "Surgemesh" is a trademark of Novus Index, LLC; the license grants no trademark rights (see TRADEMARKS.md in the repository root). Contact: dev@surgemesh.com