Overview
The Finscreener MCP Server enables Claude and other AI agents to access Finscreener’s comprehensive business data through the Model Context Protocol. Simply configure Claude Desktop with our hosted server endpoint - no local installation required.
Cloud Hosted Service - Our MCP server is hosted at mcp.finscreener.in. Just add your API key and start using it immediately with Claude Desktop.
Prerequisites
- Finscreener API Key - Format:
fsk_xxx (Get from User Profile → Security tab)
- Claude Desktop - For AI agent integration
Claude Desktop Setup
Edit the Claude Desktop configuration file:~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"finscreener": {
"url": "https://mcp.finscreener.in/sse?api_key=YOUR_API_KEY"
}
}
}
Edit the Claude Desktop configuration file:%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"finscreener": {
"url": "https://mcp.finscreener.in/sse?api_key=YOUR_API_KEY"
}
}
}
After updating the configuration, restart Claude Desktop for changes to take effect.
Server Endpoints
| Endpoint | Description |
|---|
https://mcp.finscreener.in/sse | SSE endpoint for Claude Desktop connection |
https://mcp.finscreener.in/health | Health check endpoint |
Authentication Options
You can pass your API key in three ways:
| Method | Format |
|---|
| URL Query Parameter (Recommended) | ?api_key=fsk_xxx |
| X-API-Key Header | X-API-Key: fsk_xxx |
| Authorization Header | Authorization: Bearer fsk_xxx |
| Tool | Description |
|---|
search_company | Search companies by name |
search_director | Search directors by name |
search_gst | Search GST registrations |
| Tool | Description |
|---|
get_company_details | Get company details by CIN |
get_director_details | Get director details by DIN |
get_gst_details | Get GST details by GSTIN |
Detail endpoints are limited to 100 requests per day.
| Tool | Description |
|---|
create_watchlist | Create a new watchlist |
list_watchlists | List all watchlists |
get_watchlist_details | Get watchlist contents |
| Tool | Description |
|---|
run_screener | Execute an FQL query |
create_screener | Save a new screener |
list_screeners | List saved screeners |
Complex screener queries may take up to 240 seconds to complete.
| Tool | Description |
|---|
create_order | Create a new data order |
list_orders | List all orders |
get_user_credits | Check credit balance |
| Tool | Description |
|---|
lookup_nic_code | Lookup NIC industry code |
lookup_hsn_code | Lookup HSN goods code |
lookup_sac_code | Lookup SAC services code |
FQL Query Examples
Case Sensitivity - Field names are CASE-SENSITIVE! Company queries use capitalized fields (City, State, NICCode), while GST queries use lowercase (state).
Find IT companies in Mumbai with high capital
City == 'Mumbai' AND NICCode IN [62011, 62012] AND paidUpCapital > 10000000
Find active companies in Maharashtra
State == 'Maharashtra' AND llpStatus == 'Active'
Find GST registrations in Gujarat
state == 'Gujarat' AND Status == 'Active'
Rate Limits
| Endpoint Type | Limit | Notes |
|---|
| Detail Endpoints | 100/day | Company, Director, GST details |
| Search Endpoints | Based on plan | Higher limits for premium plans |
| Screener Queries | 240s timeout | Complex queries may take longer |
| Watchlist Operations | Unlimited | Create and manage watchlists |
Troubleshooting
Connection Failed
- Verify your API key is correct and active
- Check that the URL is exactly:
https://mcp.finscreener.in/sse?api_key=YOUR_KEY
- Test the server health: https://mcp.finscreener.in/health
- Restart Claude Desktop after configuration changes
No Results from Screener
- Field names are case-sensitive! Use
City not city
- For GST queries, use lowercase
state
- Check operator syntax (use
== not =)
- Verify NIC codes are numeric, not strings
- Complex queries may take up to 240 seconds
Rate Limit Exceeded
- Detail endpoints are limited to 100 requests per day
- Wait until the next day for limits to reset
- Consider upgrading your subscription for higher limits
Invalid API Key
- API keys should start with
fsk_
- Generate a new key from User Profile → Security tab
- Ensure there are no extra spaces in your configuration
