Skip to main content
Guild’s public API, CLI, and Agent SDK let you run, build, and manage agents from your own code. Try them on a free trial account at app.guild.ai; no credit card required. See Pricing for plans.

​
Call the API

1

Create an API key

In app.guild.ai, open Settings for the account the key should act as and create a key with the scopes it needs. Or run guild api-key create. See Create a key.
2

Make a request

Send the key’s <api_key_id>:<api_key_secret> string as HTTP Basic credentials or a Bearer token.
3

Hold a conversation

Start a session with an agent, read its replies, and send follow-ups. See Conversations.
The OpenAPI spec is unauthenticated: openapi.yaml or openapi.json. Import it into an API client or code generator.

​
Resources

API reference

Base URL, authentication, scopes, errors, and every endpoint.

Quickstart

Run your first agent, then build your own with the CLI.

Guild CLI

Install the CLI, scaffold an agent, and test it locally before publishing.

Agent SDK

Build agents with tools, typed inputs, and platform services.

API triggers

Run one agent on demand with a key scoped to a single trigger.

MCP server

Call Guild operations as MCP tools from Claude Code, Cursor, or any MCP client.

​
For AI agents

  • llms.txt indexes every page; add .md to any page URL for its Markdown.
  • Search these docs from an MCP client at https://docs.guild.ai/mcp.
  • In a browser that supports WebMCP, every page registers tools that search and read these docs and look up integrations and their tools.
Last modified on October 15, 2026