Synth MCP

by maybe-finance

Not rated
GitHub

About

Access financial data like stock prices, currency info, and insider trading data using the Synth Finance API.

Details

Author
maybe-finance
Categories
Developer Tools, Other, Finance

Setup

Install Synth MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/maybe-finance/synth-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

A remote MCP (Model Context Protocol) server that provides AI assistants with access to the Synth Finance API. This server enables Claude Desktop and other MCP-compatible clients to access financial data, currency information, stock prices, insider trading data, and more through natural language queries.

- 🏦 Transaction Enrichment: Decode cryptic bank transactions into clear merchant information with logos, locations, and categories
- πŸ’± Currency Exchange Rates: Access real-time and historical exchange rates for all major currencies
- πŸ“ˆ Stock Market Data: Search tickers and retrieve historical OHLC price data
- πŸ‘” Insider Trading Data: Access comprehensive SEC Form 4 filings and executive trading activity
- πŸ‘€ User Account Info: Check API usage, credits remaining, and account details

Simply add this to your Claude Desktop configuration:

macOS:~/Library/Application Support/Claude/claude_desktop_config.json
Windows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "synth": { "url": "https://mcp.synthfinance.com/sse", "transport": "sse", "headers": { "Authorization": "Bearer YOUR_SYNTH_API_KEY" } } } }

Decode cryptic bank and credit card transactions into meaningful merchant information.

- "What is this charge: SQ COFFEE SHOP 4155551234"
- "Decode TST
MERCHANT NAME 123"
- "Identify this transaction: WM SUPERCENTER #1234"

Get real-time currency exchange rates (updated every 60 seconds).

- "What's the current USD to EUR exchange rate?"
- "Convert 100 dollars to euros"
- "Get live forex rates for major currencies"

Get historical exchange rates for any past date.

- "What was the USD to EUR rate on January 1, 2023?"
- "Get exchange rates from last month"
- "Historical EUR/USD rate for tax purposes"

Search for stock tickers by company name or symbol.

- "Find ticker for Apple"
- "What's the stock symbol for Microsoft?"
- "Search for renewable energy stocks"

Get historical stock price data (OHLC) for any date range.

- "Get AAPL stock prices for January 2024"
- "Show me Tesla's price history for last quarter"
- "OHLC data for NVDA from 2023"

Access insider trading activity and SEC Form 4 filings.

- "Show insider trades for AAPL"
- "Recent insider activity for Tesla"
- "Which executives are buying MSFT?"

Get your Synth account information and API usage.

- "Show my account information"
- "How many API credits do I have left?"
- "Check my API usage"

This MCP server includes extensive keyword optimization to ensure tools are triggered appropriately. Each tool responds to hundreds of related terms and natural language patterns, making it more likely that your queries will use the Synth API rather than web search.

git init git add . git commit -m "Initial commit" git remote add origin https://github.com/yourusername/synth-mcp.git git push -u origin main

- Go torailway.app
- Click "New Project" β†’ "Deploy from GitHub"
- Select your repository
- Railway automatically deploys!

- In Railway: Settings β†’ Networking β†’ Add your domain
- In your DNS: Add CNAME record pointing to Railway

docker build -t synth-mcp . docker run -p 3000:3000 synth-mcp
heroku create your-synth-mcp git push heroku main

- GET /health- Health check endpoint
- GET /sse- SSE endpoint for MCP communication
- POST /message- Message handling endpoint

- API keys are passed through headers and never stored on the server
- Each user provides their own Synth API key
- Always use HTTPS in production
- CORS is configured for secure cross-origin access

# Install dependencies npm install # Run in development mode npm run dev # Build for production npm run build # Start production server npm start

- PORT- Server port (default: 3000, automatically set by most hosting platforms)

Contributions are welcome! Please feel free to submit a Pull Request.

- Synth API Documentation:docs.synthfinance.com
- Get API Key:
synthfinance.com
- MCP Documentation:
modelcontextprotocol.io

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Managed MCP server for Bybit perpetual futures trading. Isolated sub-accounts, built-in risk management, 12 trading tools.

Access real-time and historical token, wallet, and trading data from the Solana ecosystem via the Solana Tracker API.

A modular trading automation project using the Zerodha Kite Connect API for tool-based and resource-based automation.

Provides access to TakeProfit.com's Indie documentation and tooling β€” a Python-based scripting language for building custom cloud indicators and trading strategies on the TakeProfit platform.

50+ pay-per-call APIs for AI agents via HTTP 402 crypto micropayments. $0.001–$0.12 per call with USDC and USDm.

Deterministic macro regime engine for AI trading agents β€” RISK_ON / NEUTRAL / RISK_OFF / STRESS with transparent scoring rules.

A quantitative analysis platform for Futu Securities, offering intelligent caching, technical analysis, and pattern recognition.

A high-performance MCP server for comprehensive options order flow analysis.

Complete MCP server for MT5: Through the MCP protocol, it allows [Trades, Orders, History, Graphic Objects, Terminal Logs, Compilation, etc.]

Integrates the xtquant quantitative trading platform with an AI assistant, enabling AI to access and operate quantitative trading data and functions.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.