Agents API | Bootspring Docs

The Agents API provides programmatic access to Bootspring's specialized AI agents. Each agent is an expert in a specific domain and can be invoked to provide specialized guidance and analysis.

Overview#

Agents are domain experts that provide contextual assistance for specific technical areas. The API allows you to:

List all available agents
Get detailed information about specific agents
Invoke agents for specialized expertise
Search for agents by expertise area

REST API Endpoints#

List All Agents#

GET /api/v1/agents

Returns a list of all available specialized agents.

Response:

{
  "data": [
    {
      "id": "database-expert",
      "name": "Database Expert",
      "description": "Expert in database design, queries, and optimization",
      "expertise": ["SQL", "Prisma", "PostgreSQL", "migrations", "query optimization"]
    },
    {
      "id": "security-expert",
      "name": "Security Expert",
      "description": "Expert in application security and best practices",
      "expertise": ["OWASP", "authentication", "authorization", "encryption", "vulnerabilities"]
    }
  ],
  "meta": {
    "total": 30,
    "requestId": "req_abc123"
  }
}

Get Agent Details#

GET /api/v1/agents/:id

Returns detailed information about a specific agent.

Parameters:

Parameter	Type	Description
`id`	string	Agent identifier (e.g., `database-expert`)

Response:

{
  "data": {
    "id": "database-expert",
    "name": "Database Expert",
    "description": "Expert in database design, queries, and optimization",
    "expertise": [
      "SQL",
      "Prisma",
      "PostgreSQL",
      "migrations",
      "query optimization"
    ]
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

Invoke Agent#

POST /api/v1/agents/:id/invoke

Invoke an agent to get specialized assistance.

Parameters:

Parameter	Type	Description
`id`	string	Agent identifier

Request Body:

{
  "context": "I need help optimizing a slow database query",
  "options": {
    "format": "code",
    "includeTests": false
  }
}

Response:

{
  "data": {
    "response": "Based on my analysis of your query...",
    "suggestions": [
      "Add an index on the user_id column",
      "Consider using a materialized view for this aggregation"
    ],
    "code": "CREATE INDEX idx_users_email ON users(email);"
  },
  "meta": {
    "agent": "database-expert",
    "executionTime": 1250,
    "requestId": "req_abc123"
  }
}

JavaScript/Node.js API#

Module Import#

const { AGENTS, getAgents, getAgent, listAgents, findAgentsByExpertise, loadAgentContext } = require('bootspring/agents');

Functions#

`getAgents()`#

Returns all available agents as an object.

const agents = getAgents();
// Returns: { 'database-expert': {...}, 'security-expert': {...}, ... }

`getAgent(name)`#

Get a specific agent by name.

Parameters:

Parameter	Type	Description
`name`	string	Agent identifier

Returns: Agent object or null if not found.

const agent = getAgent('database-expert');
// Returns:
// {
//   name: 'Database Expert',
//   expertise: ['SQL', 'Prisma', 'PostgreSQL', 'migrations', 'query optimization'],
//   description: 'Expert in database design, queries, and optimization'
// }

`listAgents()`#

Returns an array of all agent identifiers.

const agentIds = listAgents();
// Returns: ['database-expert', 'security-expert', 'frontend-expert', ...]

`findAgentsByExpertise(keyword)`#

Find agents that have expertise matching a keyword.

Parameters:

Parameter	Type	Description
`keyword`	string	Expertise keyword to search for

Returns: Array of matching agents with their IDs.

const matches = findAgentsByExpertise('React');
// Returns:
// [
//   { id: 'frontend-expert', name: 'Frontend Expert', expertise: [...], ... }
// ]

`loadAgentContext(name)`#

Load the full context file for an agent.

Parameters:

Parameter	Type	Description
`name`	string	Agent identifier

Returns: String content of the agent's context file, or null if not found.

const context = loadAgentContext('database-expert');
// Returns markdown content with full agent instructions

MCP Tool#

The bootspring_agent MCP tool provides agent functionality to AI assistants.

Tool Definition#

{
  "name": "bootspring_agent",
  "description": "Work with specialized AI agents",
  "inputSchema": {
    "type": "object",
    "properties": {
      "action": {
        "type": "string",
        "enum": ["list", "show", "invoke", "search"]
      },
      "name": {
        "type": "string",
        "description": "Agent name (e.g., database-expert)"
      },
      "topic": {
        "type": "string",
        "description": "Topic or question for the agent"
      },
      "query": {
        "type": "string",
        "description": "Search query"
      }
    },
    "required": ["action"]
  }
}

Actions#

Action	Description	Required Parameters
`list`	List all available agents	None
`show`	Show detailed info about an agent	`name`
`invoke`	Invoke agent for assistance	`name`, `topic`
`search`	Search agents by expertise	`query`

Examples#

List agents:

{
  "action": "list"
}

Show agent details:

{
  "action": "show",
  "name": "database-expert"
}

Invoke an agent:

{
  "action": "invoke",
  "name": "security-expert",
  "topic": "How do I implement rate limiting for my API?"
}

Search for agents:

{
  "action": "search",
  "query": "authentication"
}

Available Agents#

Technical Agents#

Agent ID	Name	Expertise Areas
`database-expert`	Database Expert	SQL, Prisma, PostgreSQL, migrations, query optimization
`security-expert`	Security Expert	OWASP, authentication, authorization, encryption
`frontend-expert`	Frontend Expert	React, Next.js, Tailwind, components, state management
`backend-expert`	Backend Expert	Node.js, APIs, server actions, middleware, serverless
`api-expert`	API Expert	REST, GraphQL, tRPC, webhooks, API design
`testing-expert`	Testing Expert	Vitest, Jest, Playwright, coverage, TDD
`performance-expert`	Performance Expert	optimization, caching, profiling, Core Web Vitals
`devops-expert`	DevOps Expert	CI/CD, Docker, deployment, monitoring
`architecture-expert`	Architecture Expert	system design, patterns, scalability, microservices

Business Agents#

Agent ID	Name	Expertise Areas
`product-expert`	Product Expert	product strategy, roadmapping, feature prioritization
`marketing-expert`	Marketing Expert	digital marketing, SEO, content strategy
`growth-expert`	Growth Expert	PLG, retention, acquisition, viral loops
`sales-expert`	Sales Expert	B2B sales, pricing, demos, negotiation
`financial-expert`	Financial Expert	financial modeling, projections, unit economics

Error Handling#

Agent Not Found#

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Agent not found: invalid-agent",
    "details": []
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

Invalid Action#

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Unknown action: invalid",
    "details": [
      { "field": "action", "message": "Must be one of: list, show, invoke, search" }
    ]
  }
}

Best Practices#

Choose the right agent: Match your task to the agent's expertise for best results
Provide context: When invoking, include relevant details about your project and goals
Combine agents: Complex tasks may benefit from multiple agent perspectives
Use search: When unsure which agent to use, search by keyword