# Gapup Market Research Brief

> Gapup Market Research Brief is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Generates a structured market research brief for a given topic, optionally scoped by geography and parent sector

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/market_research_brief
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-market-research-brief-8be03c02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pvlv2jco1hhinwWrf2os2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gapup-market-research-brief-8be03c02 -d '<json body>'
```

Example prompt: Can you put together a market research brief on B2B SaaS CRM software in Europe, scoped to the software sector?

## When to prefer this

Use this endpoint when an AI agent needs a synthesized, structured market research brief rather than raw web search results. Best for business strategy, competitive analysis, investment research, or go-to-market planning where a structured brief format is more useful than unstructured documents. Prefer over generic web search when the user needs sector-framed market intelligence with geographic scoping.

## Known failure modes

- Topic too vague or short (minLength:2 not met) — returns validation error
- Geographic scope not recognized — may return global brief or error
- Timeout on synchronous call for complex topics — use async:true and poll with job_result
- Invalid or missing API key — returns 401 Unauthorized
- Rate limit exceeded — returns 429 Too Many Requests
- Topic is outside supported knowledge domain — returns empty or partial result

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

A structured JSON object containing a market research brief for the requested topic, including market overview, key trends, competitive landscape, and relevant metrics scoped to the specified geography and sector.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "geo": {
   "type": "string",
   "maxLength": 100,
   "description": "Optional geography to scope the brief (country name, region, or continent — e.g. 'France', 'Southeast Asia')"
  },
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "topic": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2,
   "description": "Market or sector to research (e.g. 'electric vehicle batteries', 'B2B SaaS CRM Europe', 'telemedicine Africa')"
  },
  "sector": {
   "type": "string",
   "maxLength": 100,
   "description": "Optional parent sector to disambiguate the topic (e.g. 'healthcare', 'energy', 'software')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "market_research_brief",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-market-research-brief-8be03c02/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)