Developer Resources

Growth Choice Public API

All Growth Choice API endpoints are publicly accessible — no API keys, no accounts, no authentication required. Integrate directly with the MCP server, NLWeb endpoint, or REST API.

OpenAPI Spec MCP Docs Auth Guide LLM Index

Authentication

No authentication required. All Growth Choice API endpoints accept unauthenticated requests. No API keys, no OAuth tokens, no account registration. Send requests directly to any endpoint.

See /auth.md for the full agent authentication specification and /.well-known/oauth-protected-resource for the RFC 9728 protected resource metadata.

Versioning & Stability

The current API version is v1, returned in the X-API-Version response header on all endpoints.

Breaking changes are announced via the Sunset response header (RFC 8594) at least 90 days before removal. Deprecated endpoints also return a Deprecation header with the deprecation date. Non-breaking additions (new fields, new tools) are made without notice.

Rate Limits

Soft rate limit: 1,000 requests per hour per IP. Every API response includes standard rate-limit headers:

RateLimit-Limit: 1000 — requests allowed per window
RateLimit-Remaining: N — requests remaining
RateLimit-Reset: {unix-timestamp} — window reset time
Retry-After: N — seconds to wait (only on 429 responses)

For high-volume agent integrations, contact info@growth-choice.com.

Error Responses

All REST endpoints return errors as application/problem+json (RFC 9457).

{
  "type": "https://growth-choice.com/developers#errors",
  "title": "Bad Request",
  "status": 400,
  "detail": "query is required",
  "instance": "/api/ask"
}

400Bad Request

404Not Found

405Method Not Allowed

429Rate Limited

500Internal Error

API Endpoints

POST/api/mcpAuth: None

MCP Streamable HTTP Transport

Model Context Protocol (MCP 2025-11-25) JSON-RPC endpoint. Supports tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get. Returns JSON or SSE depending on Accept header.

curl -X POST https://growth-choice.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

POST/api/askAuth: None

NLWeb Natural Language Query

NLWeb v0.55 endpoint. Send a natural language question, receive structured results from the Growth Choice knowledge base. Supports SSE streaming with prefer.streaming: true.

curl -X POST https://growth-choice.com/api/ask \
  -H "Content-Type: application/json" \
  -d '{"query":"What Google Ads services does Growth Choice offer?"}'

GET/openapi.jsonAuth: None

OpenAPI 3.1 Specification

Full machine-readable API specification in OpenAPI 3.1 format.

curl https://growth-choice.com/openapi.json

GET/llms.txtAuth: None

LLM Navigation Index

Navigation index for AI agents with markdown links to all key resources.

curl https://growth-choice.com/llms.txt

GET/auth.mdAuth: None

Authentication Documentation

Full agent authentication documentation. Growth Choice APIs are public — no credentials required.

curl https://growth-choice.com/auth.md

MCP Tools (13)

All tools are read-only (readOnlyHint: true). Retrieve the full list via tools/list.

search_knowledge

Universal search across all Growth Choice public knowledge

get_context_bundle

Assemble a complete structured context package for a query

get_company_profile

Verified Growth Choice company facts with sources

list_services

Complete service directory with optional industry filter

get_service

Single service detail by slug

list_case_studies

Case study list with industry and service filters

get_case_study

Full verified case study detail with documented results

get_verified_results

Documented performance metrics only, with source attribution

search_marketing_guides

Search Growth Choice blog articles and educational guides

get_article

Single article key takeaways by slug

get_industry_expertise

Industry-specific experience bundle

get_recent_updates

Content updated since a given date

get_contact_info

Public contact information only

Discovery Resources

/.well-known/ard.json

ARD Catalog

All agentic resources

/.well-known/mcp.json

MCP Manifest

MCP server discovery

/.well-known/mcp/server-card.json

MCP Server Card

Server metadata

/.well-known/agent-card.json

A2A Agent Card

Agent-to-Agent protocol

/.well-known/oauth-protected-resource

Agent Plugins catalog

Questions?

Email info@growth-choice.com for integration support, high-volume access, or to report an API issue.