@versepress/mcp
v1.0.0
Published
MCP server for the Verse Press crypto news API
Maintainers
Readme
Verse Press MCP Server
An MCP server for the Verse Press API. Gives AI assistants access to crypto news from Asia, Africa, Latin America, and the Middle East.
Tools
| Tool | Description | Auth required |
|------|-------------|:---:|
| get_headlines | Top headlines with region, category, source, and keyword filters | Yes |
| search_articles | Full-text search with date range, sort, and title-only options | Yes |
| get_article | Read a single article by slug | Yes |
| get_sources | List available news sources | No |
| register_email | Register for a free API key via email verification | No |
| get_wallet_nonce | Get a signing challenge for VERSE token holder registration | No |
| verify_wallet | Submit signed nonce to complete token holder registration | No |
| health_check | Check API status (basic or detailed with DB/Redis) | No |
Setup
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"verse-press": {
"command": "npx",
"args": ["-y", "@versepress/mcp"],
"env": {
"VERSE_PRESS_API_KEY": "vp_your-key-here"
}
}
}
}Claude Code
claude mcp add verse-press -- npx -y @versepress/mcp
# Set your API key in the environment
export VERSE_PRESS_API_KEY=vp_your-key-hereFrom source
git clone https://github.com/jtxmp/verse-press-mcp.git
cd verse-press-mcp
pnpm install
pnpm build
# Then configure your MCP client to run:
node /path/to/verse-press-mcp/dist/index.jsGet an API Key
Free tier (100 requests/day):
npx @versepress/cli
# Follow the interactive setup, or:
npx @versepress/cli auth register [email protected]Token holder tier (1,000 requests/day):
Hold VERSE tokens in an Ethereum or Polygon wallet. See the CLI docs for wallet verification steps.
Custom rates: [email protected]
Environment Variables
| Variable | Purpose |
|----------|---------|
| VERSE_PRESS_API_KEY | API key for authenticated endpoints |
| VERSE_PRESS_URL | Override the base URL (default: https://api.press.vgdh.io) |
Example Prompts
Once connected, you can ask your AI assistant:
- "What are the latest crypto headlines from Asia?"
- "Search for articles about stablecoin regulation in Latin America"
- "Read the article with slug bitcoin-etf-inflows-hit-record"
- "What news sources does Verse Press cover?"
- "Register me for a Verse Press API key with my email"
- "Is the Verse Press API healthy?"
Links
- CLI: npmjs.com/package/@versepress/cli
- API docs: api.press.vgdh.io/docs
- Community: t.me/GetVerse
License
MIT
