pounce-mcp-server
v2.1.0
Published
MCP Server for Pounce v2 Entity API - Connect AI agents to 65M+ verified B2B companies
Maintainers
Readme
Pounce MCP Server
Connect AI agents to 65M+ verified B2B companies via Model Context Protocol (MCP)
Overview
This MCP server provides AI assistants (like Claude, Cursor, etc.) with access to the Pounce v2 Entity API. Your AI can search for companies, look up by domain, and retrieve full company profiles.
Features:
- Semantic Search — Natural language queries like "AI startups in healthcare"
- Structured Filters — Country, city, founding year, employee range, domain, sort
- Domain Lookup — Instant company identification by domain
- Full Profiles — Trade register data, tech stack, financials, social links
- GDPR Compliant — No personal contact data exposed
Quick Start
1. Get Your API Key
- Sign up at pounce.ch/register (Free plan, 100 calls/month)
- Go to Dashboard → API Keys
- Generate your key
2. Install in Cursor
Add to your ~/.cursor/mcp.json:
{
"mcpServers": {
"pounce": {
"command": "npx",
"args": ["-y", "pounce-mcp-server"],
"env": {
"POUNCE_API_KEY": "your_api_key_here"
}
}
}
}Restart Cursor (Cmd+Shift+P → "Reload Window"). Done!
3. Install in Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"pounce": {
"command": "npx",
"args": ["-y", "pounce-mcp-server"],
"env": {
"POUNCE_API_KEY": "your_api_key_here"
}
}
}
}Restart Claude Desktop. Done!
Available Tools
search_companies
Search verified B2B companies using AI semantic search (2 credits per call).
| Name | Type | Required | Description |
|------|------|----------|-------------|
| query | string | Yes | Natural language query |
| country | string | No | ISO country code (US, DE, GB, CH...) |
| limit | number | No | Max results (1-100, default: 25) |
Example prompts:
- "Find AI startups in healthcare"
- "Search for SaaS companies using React in Germany"
- "Show me fintech companies in Switzerland"
filter_companies
Search companies with structured filters (1 credit per call). Better for precise filtering.
| Name | Type | Required | Description |
|------|------|----------|-------------|
| query | string | No | Keyword search query |
| country | string | No | ISO country code |
| city | string | No | City name (e.g. Zurich, Berlin) |
| category | string | No | Industry category |
| founded_min | number | No | Minimum founding year |
| founded_max | number | No | Maximum founding year |
| first_seen_after | string | No | ISO date, only entities indexed after this date |
| employee_range | string | No | 1-10, 11-50, 51-200, 201-500, 500+ |
| has_domain | boolean | No | Only companies with a known domain |
| sort | string | No | relevance, newest, oldest, quality |
| limit | number | No | Max results (1-100, default: 25) |
Example prompts:
- "Find companies in Zurich founded after 2020 with more than 50 employees"
- "List German fintech companies sorted by newest"
- "Show all Swiss companies with a domain, sorted by quality"
lookup_company
Look up a company by its domain name (1 credit per call).
| Name | Type | Required | Description |
|------|------|----------|-------------|
| domain | string | Yes | Domain to look up (e.g. "stripe.com") |
Example prompts:
- "Look up stripe.com on Pounce"
- "What company is behind notion.so?"
company_detail
Get the full company profile with all data (1 credit per call).
| Name | Type | Required | Description |
|------|------|----------|-------------|
| entity_id | number | Yes | Entity ID from search/lookup results |
Example prompts:
- "Get the full details for company 123456"
- "Show me everything about that first company"
Response Format
Each company includes:
Company: Acme AI AG
Domain: acme-ai.ch
Country: CH · City: Zurich
Trust: T4 · Quality: 87%
Categories: artificial-intelligence, saas
Tech Stack: react, typescript, python, fastapi
Employees: ~45Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| POUNCE_API_KEY | Yes | Your Pounce API key |
| POUNCE_API_BASE | No | API base URL (default: https://api.pounce.ch) |
API Plans
| Plan | Credits/Month | Rate Limit | |------|---------------|------------| | Free | 100 | 30/min | | Developer | 5,000 | 60/min | | Business | 25,000 | 300/min | | Enterprise | 200,000 | 1,000/min |
Local Development
cd mcp/pounce-mcp-server
npm install
npm run build
POUNCE_API_KEY=your_key node dist/index.jsTroubleshooting
"POUNCE_API_KEY environment variable is required"
Make sure your MCP config has the env section with your API key.
"Pounce API error (401)"
Your API key is invalid or expired. Generate a new one at pounce.ch/register.
"Pounce API error (429)"
Rate limit or quota exceeded. Check your usage at Dashboard → API Keys.
Links
- Documentation: pounce.ch/api
- API Reference: api.pounce.ch/docs
- Skill File: pounce.ch/skill.md
- Support: [email protected]
License
MIT
Pounce — Verified B2B Company Intelligence for AI Agents
