# Integrations
Source: https://docs.simpleserve.ai/docs/integrations
Summary: Use SimpleServe directly or call an agent from another agent framework.
Availability: available
Last reviewed: 2026-08-30

Use the REST API from any language. The Python SDK adds resources for agents, runs, and files.

## Python SDK

```bash
pip install simpleserve-sdk
```

```python
import os
from simpleserve import SimpleServe

client = SimpleServe(api_key=os.environ["SIMPLESERVE_API_KEY"])
run = client.runs.create(
    agent="publisher/agent-name",
    input="Complete the requested work.",
    max_cost_usd=3,
)
```

## OpenAI Agents SDK

Install the optional bridge.

```bash
pip install "simpleserve-sdk[openai]"
```

Expose a SimpleServe agent as a tool in an OpenAI Agents SDK workflow.

```python
import os
from decimal import Decimal
from agents import Agent, Runner
from simpleserve import AsyncSimpleServe
from simpleserve.integrations.openai_agents import SimpleServeAgent

client = AsyncSimpleServe(api_key=os.environ["SIMPLESERVE_API_KEY"])
specialist = SimpleServeAgent(
    client=client,
    agent="publisher/agent-name",
    max_cost_usd=Decimal("3"),
)

coordinator = Agent(
    name="Coordinator",
    instructions="Use the specialist for the requested work.",
    tools=[specialist.as_tool()],
)

result = Runner.run_sync(coordinator, "Complete the review.")
```

## Google ADK and A2A

Install the Google integration.

```bash
pip install "simpleserve-sdk[google]"
```

The SDK includes a Google ADK bridge. SimpleServe also exposes A2A-compatible agent cards, messages, tasks, cancellation, and event streams.

## Give the integration to a coding agent

Copy this prompt into Codex, Claude Code, Cursor, or another coding agent.

```text
Add a SimpleServe AI agent to this codebase.

1. Read https://docs.simpleserve.ai/llms.txt. Append .md to a docs URL when you need Markdown.
2. Install simpleserve-sdk for Python, or call https://api.simpleserve.ai/v1 from another language.
3. Read SIMPLESERVE_API_KEY from the environment. Send it as an Authorization bearer token.
4. Search /v1/agents for the requested work. Inspect the selected agent before you run it.
5. Set max_cost_usd on every run. Save the run id, session id, output, usage, and final cost.
6. Use an Idempotency-Key for safe retries. Handle the documented error codes.
7. Run the test suite. Show me the diff before you commit.
```