API Documentation

Integrate Agent Teams Market into your toolchain. REST API, MCP server, and semantic discovery.

Getting Started

The Agent Teams Market API lets you discover, fetch, and export AI agent team specifications programmatically. No authentication is required for free-tier usage.

Base URL

https://teamsmarket.dev

Authentication

Include your API key as a Bearer token for Pro+ access. Free tier (50 req/mo) works without a token.

Authorization: Bearer YOUR_API_KEY

Endpoints

GET/api/teams

List all team specs. Supports filtering by category and full-text search.

Parameters

Name	Type	Required	Description
category	string	optional	Filter by category slug (e.g. software-development)
q	string	optional	Full-text search across name, description, and tags

Example Request

curl https://teamsmarket.dev/api/teams

Example Response

{
  "teams": [
    {
      "slug": "fullstack-dev-team",
      "name": "Full-Stack Dev Team",
      "description": "End-to-end web development team...",
      "category": "software-development",
      "agentCount": 6,
      "difficulty": "intermediate",
      "tags": ["react", "node", "typescript"]
    }
  ],
  "total": 62
}

GET/api/teams/{slug}

Fetch full detail for a specific team spec including rendered HTML content.

Parameters

Name	Type	Required	Description
slug	string	required	The team's URL slug (e.g. fullstack-dev-team)

Example Request

curl https://teamsmarket.dev/api/teams/fullstack-dev-team

Example Response

{
  "slug": "fullstack-dev-team",
  "name": "Full-Stack Dev Team",
  "description": "End-to-end web development...",
  "agentCount": 6,
  "difficulty": "intermediate",
  "version": "1.0.0",
  "tags": ["react", "node", "typescript"],
  "content": "# Full-Stack Dev Team\n..."
}

GET/api/teams/{slug}/spec

Returns the raw Markdown spec file. Ideal for piping directly into AGENTS.md or .cursorrules.

Parameters

Name	Type	Required	Description
slug	string	required	The team's URL slug

Example Request

curl https://teamsmarket.dev/api/teams/fullstack-dev-team/spec > AGENTS.md

Example Response

# Full-Stack Dev Team

## Overview
A coordinated team of AI agents covering the full web development lifecycle...

### 1. Architect Agent
...

GET/api/teams/{slug}/export

Export a team spec in a structured format for agent frameworks. Pro+ required for non-markdown formats.

Parameters

Name	Type	Required	Description
slug	string	required	The team's URL slug
format	string	required	One of: markdown, crewai, autogen, langgraph, openclaw

Example Request

curl "https://teamsmarket.dev/api/teams/fullstack-dev-team/export?format=crewai"

Example Response

# CrewAI export
agents:
  - role: Architect Agent
    goal: Design scalable system architecture
    backstory: Expert in distributed systems...
    tools: [code_analysis, diagram_generation]
...

GET/api/discover

Semantic discovery: describe a task in natural language and get ranked team recommendations.

Parameters

Name	Type	Required	Description
task	string	required	Natural language description of your task or workflow
limit	number	optional	Max results to return (default: 5)

Example Request

curl "https://teamsmarket.dev/api/discover?task=migrate+rails+monolith+to+microservices"

Example Response

{
  "recommendations": [
    {
      "slug": "fullstack-dev-team",
      "name": "Full-Stack Dev Team",
      "score": 0.94,
      "reason": "Strong match for migration and architecture tasks"
    }
  ]
}

GET/api/compose

Compose a multi-team configuration for complex tasks that span multiple domains.

Parameters

Name	Type	Required	Description
task	string	required	The complex task to decompose into team responsibilities

Example Request

curl "https://teamsmarket.dev/api/compose?task=build+and+launch+a+saas+product"

Example Response

{
  "composition": [
    { "slug": "fullstack-dev-team", "role": "core development" },
    { "slug": "devops-team", "role": "infrastructure & deployment" },
    { "slug": "seo-growth-team", "role": "launch & growth" }
  ]
}

GET/api/mcp

Returns the MCP tool manifest. Used by Claude and Cursor to discover available tools.

Example Request

curl https://teamsmarket.dev/api/mcp

Example Response

{
  "tools": [
    {
      "name": "search_teams",
      "description": "Search agent team specs by keyword or category",
      "inputSchema": { ... }
    },
    {
      "name": "get_team_spec",
      "description": "Fetch the full spec for a team by slug",
      "inputSchema": { ... }
    }
  ]
}

POST/api/mcp

Execute an MCP tool. Send a JSON body with the tool name and input parameters.

Parameters

Name	Type	Required	Description
tool	string	required	Tool name (e.g. search_teams, get_team_spec)
input	object	required	Tool-specific input parameters

Example Request

curl -X POST https://teamsmarket.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_teams","input":{"q":"kubernetes"}}'

Example Response

{
  "result": {
    "teams": [
      { "slug": "kubernetes-platform-team", "name": "Kubernetes Platform Team" }
    ]
  }
}

Rate Limits

Free Tier

100 requests per month, rate limited by IP address.

Pro & Team

Unlimited requests with Bearer token authentication.

Enterprise

Custom volume pricing and dedicated infrastructure. Contact sales.

Rate limit headers are included in every response:

X-RateLimit-Remaining: calls remaining this month
X-RateLimit-Reset: Unix timestamp when limit resets

SDKs & Integration

cURL

# List all teams
curl https://teamsmarket.dev/api/teams

# Search teams
curl "https://teamsmarket.dev/api/teams?q=kubernetes&category=devops-infrastructure"

# Get a team spec (pipe to AGENTS.md)
curl https://teamsmarket.dev/api/teams/fullstack-dev-team/spec > AGENTS.md

# Export as CrewAI (requires Pro token)
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://teamsmarket.dev/api/teams/fullstack-dev-team/export?format=crewai"

Python

import httpx

BASE_URL = "https://teamsmarket.dev/api"
TOKEN = "YOUR_API_KEY"  # optional for Pro features

headers = {"Authorization": f"Bearer {TOKEN}"}

# List teams by category
response = httpx.get(f"{BASE_URL}/teams", params={"category": "software-development"})
teams = response.json()["teams"]
print(f"Found {len(teams)} teams")

# Get a specific team
team = httpx.get(f"{BASE_URL}/teams/fullstack-dev-team").json()
print(team["name"])

# Semantic discovery
result = httpx.get(
    f"{BASE_URL}/discover",
    params={"task": "migrate rails monolith to microservices"},
    headers=headers,
).json()
for rec in result["recommendations"]:
    print(f"{rec['name']} (score: {rec['score']})")

TypeScript / JavaScript

const BASE_URL = "https://teamsmarket.dev/api";
const TOKEN = process.env.TEAMSMARKET_API_KEY; // optional

async function listTeams(category?: string) {
  const url = new URL(`${BASE_URL}/teams`);
  if (category) url.searchParams.set("category", category);

  const res = await fetch(url.toString(), {
    headers: TOKEN ? { Authorization: `Bearer ${TOKEN}` } : {},
  });
  return res.json();
}

async function discoverTeams(task: string) {
  const url = new URL(`${BASE_URL}/discover`);
  url.searchParams.set("task", task);

  const res = await fetch(url.toString(), {
    headers: TOKEN ? { Authorization: `Bearer ${TOKEN}` } : {},
  });
  return res.json();
}

// Usage
const { teams } = await listTeams("devops-infrastructure");
const { recommendations } = await discoverTeams("set up CI/CD for a Next.js app");

MCP (Claude / Cursor)

Add Agent Teams Market as an MCP server in your Claude or Cursor config:

// ~/.cursor/mcp.json  (or Claude Desktop equivalent)
{
  "mcpServers": {
    "teamsmarket": {
      "url": "https://teamsmarket.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Once configured, Claude and Cursor can use tools like search_teams, get_team_spec, and discover_teams directly from chat.

Ready to build?

Upgrade to Pro for unlimited API access, multi-format export, and semantic discovery.

View Pricing OpenAPI Spec