GitHub - altmbr/teahose-mcp · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
altmbr
teahose-mcp
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>7 Commits<br>7 Commits
.claude-plugin
.claude-plugin
scripts
scripts
src
src
test
test
.gitignore
.gitignore
.mcp.json
.mcp.json
LICENSE
LICENSE
README.md
README.md
package-lock.json
package-lock.json
package.json
package.json
tsconfig.json
tsconfig.json
vitest.config.ts
vitest.config.ts
View all files
Repository files navigation
teahose-mcp
Live AI-company intelligence for Claude — funding signals, lookalike search, podcast/newsletter buzz, and emerging market themes, all drawn from the Teahose intel graph. No API key required to start; a free key unlocks higher rate limits and daily-email alerts.
claude mcp add teahose -- npx -y teahose-mcp
Or install as a Claude Code plugin (this repo doubles as a plugin marketplace):
/plugin marketplace add altmbr/teahose-mcp<br>/plugin install teahose@teahose-mcp
Tools
Tool<br>Description
find_companies<br>Vector search over the Teahose AI-company graph — pass a competitor URL or a plain-text description to find similar companies with similarity scores.
who_is_talking_about<br>What operators, VCs, and newsletters are saying about a company — mention signals from podcasts and newsletters, with source and episode.
latest_funding<br>Fresh funding rounds across the AI landscape — amount, round, investors, dated and sourced. Optionally filter by theme slug.
check_companies<br>Batch-check a list of company names (portfolio, CRM, watchlist) to see which had signals in the last 7 or 30 days.
emerging_themes<br>Machine-discovered AI market themes ranked emerging-first with 7-day signal volume.
get_company<br>Profile of an AI company: what it does, sector, themes, and recent funding/product/hiring/mention signals.
watch_company<br>Subscribe to daily email alerts whenever a company has new signals. Requires a free API key.
Security & Privacy
This server is a thin, read-only HTTP client. A security review should find:
Network access: The only endpoint contacted is https://www.teahose.com/api/mcp/v1/*. No other outbound requests are made.
No filesystem or shell access: The server does not read, write, or execute anything on the local filesystem.
No exec / child processes: No child_process, eval, or dynamic code execution of any kind.
No telemetry: The server emits no analytics, crash reports, or tracking beyond the API calls themselves. The API calls are subject to Teahose's privacy policy.
Credential scope: The only credential is the optional TEAHOSE_API_KEY environment variable. It is sent solely to teahose.com in an x-teahose-key request header.
Dependencies: Exactly two runtime dependencies — @modelcontextprotocol/sdk and zod. No native addons.
No postinstall scripts: package.json has no install, postinstall, or prepare hooks.
All tools are read-only except watch_company (which writes a watch subscription on teahose.com) and requires a valid API key.
Free Tier vs. Free Key
A free Teahose API key is available at https://www.teahose.com/mcp . Getting a key also subscribes you to the Teahose daily-digest email (unsubscribe any time).
Limit<br>Keyless<br>Free key
Requests / minute<br>10<br>30
Requests / day<br>50<br>1,000
Company signals returned<br>25
Buzz mentions returned<br>25
Funding rows returned<br>15 (max 14-day window)<br>50 (max 30-day window)
check_companies names<br>10<br>50
find_companies matches<br>15
Configuration
Variable<br>Required<br>Description
TEAHOSE_API_KEY<br>No<br>Free key from https://www.teahose.com/mcp. Unlocks higher limits and watch_company.
TEAHOSE_API_URL<br>No<br>Override the API base URL (useful for local testing against a dev server).
Setting your key in Claude Code
Add an env block to your MCP server entry in .claude/settings.json:
"mcpServers": {<br>"teahose": {<br>"command": "npx",<br>"args": ["-y", "teahose-mcp@latest"],<br>"env": {<br>"TEAHOSE_API_KEY": "your-key-here"
Or set TEAHOSE_API_KEY in your shell environment before...