Content
<p align="center">
<img src="https://raw.githubusercontent.com/getgapup/gapup-mcp-public/main/assets/logo-512.png" alt="Gapup MCP" width="128" height="128" />
</p>
# Gapup MCP
[English](README.md) · [Français](README.fr.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [中文](README.zh-CN.md) · [한국어](README.ko.md) · [Português (BR)](README.pt-BR.md)
[](https://smithery.ai/servers/gapup-team/gapup-mcp)
[](https://glama.ai/mcp/servers/getgapup/gapup-mcp)
[](https://registry.modelcontextprotocol.io)
[](https://mcp.gapup.io/health)
[](https://x402.org)
[](https://hub.gapup.io/agents-api/onboard)
[](LICENSE)
**Agent-payable C-suite knowledge — 271 tools, x402 micro-payments, board-ready JSON.**
Live endpoint: `https://mcp.gapup.io/mcp`
Free tier: 100 calls/month, no credit card → [hub.gapup.io/agents-api/onboard](https://hub.gapup.io/agents-api/onboard)
---
## What is Gapup MCP?
A hosted [Model Context Protocol](https://modelcontextprotocol.io) server exposing **100+ business expertise tools** for AI agents. Each tool returns a structured, audited, board-ready JSON deliverable in 1-30 seconds.
Pay-per-call via [x402](https://x402.org) (USDC + EURC on Base + Optimism). No subscription, no API gateway. The price is encoded in the response — agents pay what they consume.
## Why agents use it
- **Board-ready output** — Zod-typed JSON, persona-stricte, no chat fluff
- **Dual-audience format** — `audience` param routes `human` (Mistral gold-standard, ~30s) vs `agent` (Cerebras qwen-3-235b, <5s)
- **Source-grounded** — citations, DOIs, evidence trails; no hallucinated facts
- **EU-first moats** — DVF Cerema + Géorisques for real estate, OFAC + EU + UK + UN + SECO + SEMA + DFAT for sanctions
- **Free tier real** — 100 calls/mo without credit card, no rate-limit games
## What's inside (271 tools)
### Top 10 C-suite expertises (most used)
- `competitive_intel` — EDGAR + Yahoo + Wayback + Wikipedia multi-source deep-dive
- `sec_filing_decoder` — 10-K / 10-Q / 8-K extraction + KPIs movement + red flags + M&A signals
- `sanctions_screener_multi` — 8 lists parallel (OFAC + EU + UK + UN + SECO + SEMA + DFAT) + PEP + adverse media
- `kyc_screener` — KYC/AML 6 sources refreshed weekly
- `pentest_scope_estimator` — PTES scope + effort/cost ranges
- `attack_surface_monitor` — passive recon (crt.sh + DNS + Shodan) + CVE/EPSS/KEV
- `clinical_evidence_briefer` — PubMed + ClinicalTrials.gov + OpenFDA, GRADE-graded
- `re_deal_screener` — EU-first real estate (DVF Cerema + Géorisques)
- `research_paper_qa` — OpenAlex 45M open-access + Semantic Scholar + CORE, DOI-cited
- `industry_classifier_naics_sic` — NAICS + SIC + NACE + GICS + ISIC + HS with hierarchy + confidence
### Categories (full list in [docs/API.md](docs/API.md))
Business Intelligence · Finance · Compliance · Strategy · Sales · Sustainability · Research · Real Estate · Healthcare · Security
## Quick start
### Option 1 — Direct HTTP (MCP Streamable HTTP)
```bash
# Free tier: get a key at https://hub.gapup.io/agents-api/onboard
export GAPUP_API_KEY=gpk_your_free_key
curl -X POST https://mcp.gapup.io/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "x-api-key: $GAPUP_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"id": 1,
"params": {
"name": "industry_classifier_naics_sic",
"arguments": {
"company_description": "Maritime freight forwarder, reefer containers, intra-EU",
"company_name": "Helios Cold Chain"
}
}
}'
```
### Option 2 — Smithery CLI
```bash
npm install -g @smithery/cli
smithery auth login
smithery mcp add gapup-team/gapup-mcp
```
### Option 3 — Claude Desktop / Cursor / Windsurf / etc.
Add to your MCP config (see [docs/CLIENTS.md](docs/CLIENTS.md) for all 30+ supported clients):
```json
{
"mcpServers": {
"gapup": {
"type": "http",
"url": "https://mcp.gapup.io/mcp",
"headers": {
"x-api-key": "gpk_your_free_key"
}
}
}
}
```
### Option 4 — TypeScript SDK example
See [client/example.ts](client/example.ts).
## Pricing
| Tier | $ USD | Examples |
|---|---|---|
| T0 | $0.002 | FX lookups, simple commodity prices |
| T1 | $0.05 | Industry classifier, pentest scope estimator |
| T2 | $0.10 | Domain tech fingerprint, market sizing |
| T3 | $0.15 | Attack surface, SEC filings, sanctions multi |
| T4 | $0.20 | Real estate deal screener, clinical evidence, KYC, AI Act audit |
| T5 | $0.30 | Competitive deep dive flagship |
| T6 | $1.50 | Async batch (bulk KYC, AI governance full report) |
**Free tier**: 100 calls/month total across all tiers. No credit card.
Full details: [docs/PRICING.md](docs/PRICING.md).
## Architecture (high-level)
```
agent ─→ mcp.gapup.io ─→ Cluster PM2 (2 instances, Cerebras-backed for agent mode)
│ │
│ └─→ Fly.io edges (fra/sin/gru) for global low-latency
│
└─→ Cloudflare WAF + rate-limit + cache
```
Full architecture: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
## Observability
- Sentry (errors + perf + breadcrumbs + x402 caller identification)
- Health endpoint with LLM providers status + circuit breakers
- Cloudflare access logs
- `/__metrics` endpoint (rate-limit-aware)
## Distribution
Listed on (verified live):
- **Smithery** — [smithery.ai/servers/gapup-team/gapup-mcp](https://smithery.ai/servers/gapup-team/gapup-mcp)
- **Glama** — [glama.ai/mcp/servers/getgapup/gapup-mcp](https://glama.ai/mcp/servers/getgapup/gapup-mcp)
- **MCP Registry officiel** — `io.github.getgapup/gapup-mcp` (also feeds GitHub MCP Registry, Augment Code Discovery, …)
- **abordage/awesome-mcp** — Compliance & Regulatory section
- **PulseMCP, mcp.so, mcp.directory, Cline MCP Marketplace, MCP Server Finder, MintMCP** — submitted, indexation pending
- **6 awesome-list PRs open** — punkpeye × 2, xpaysh × 2, rohitg00, TensorBlock
- Bazaar / x402.org coming post-LLC (mid-June 2026)
## License & usage
The contents of THIS repository (manifests, docs, SDK examples, governance files) are licensed under **[MIT](LICENSE)** — you can fork, translate, reuse the snippets, contribute back.
The hosted API at `mcp.gapup.io` is governed separately by the [Gapup Terms of Service](https://hub.gapup.io/terms). The MIT grant does NOT cover commercial API usage at scale — that's a per-call x402 settlement.
The **server implementation itself is private** (closed-source). This repository contains zero server source code — only the public surface (manifests + docs + examples) that lets clients integrate with the hosted endpoint.
## Support
- **Email**: agents@gapup.io
- **Issues**: [GitHub Issues](https://github.com/getgapup/gapup-mcp-public/issues)
- **Docs**: [hub.gapup.io/agents-api](https://hub.gapup.io/agents-api)
## Built with
Claude Code · TypeScript · MCP SDK · x402 protocol · Cerebras + Mistral + Anthropic
---
© 2026 Gapup. All rights reserved.
