OpenAI Agents SDK - Alchemist

The OpenAI Agents SDK acts as an MCP client directly, your app connects to Alchemist over Streamable HTTP and the tools become available to the agent. Authenticate with your API key on the Authorization header. Get a key at app.askalchemist.com/settings/api-keys.

Python

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Alchemist",
    params={
        "url": "https://api.askalchemist.com/mcp/",
        "headers": {"Authorization": "Bearer alch_YOUR_KEY"},
    },
) as server:
    agent = Agent(name="Assistant", mcp_servers=[server])

TypeScript / JavaScript

import { Agent, MCPServerStreamableHttp } from '@openai/agents';

const server = new MCPServerStreamableHttp({
  url: 'https://api.askalchemist.com/mcp/',
  name: 'Alchemist',
  requestInit: { headers: { Authorization: 'Bearer alch_YOUR_KEY' } },
});
const agent = new Agent({ name: 'Assistant', mcpServers: [server] });
await server.connect();

The JS SDK also accepts an authProvider (the MCP TypeScript SDK’s OAuthClientProvider) if you’d rather run the OAuth flow than pass a static key.

To let OpenAI’s model call Alchemist server-side instead of connecting from your process, use the Responses API (or the SDK’s HostedMCPTool / hostedMcpTool wrappers).