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).