{"id":"saidsurucu-borsa-mcp","name":"borsa-mcp","homepage":null,"repo_url":"https://github.com/saidsurucu/borsa-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","fastmcp","finance-data","stocks","tefas","crypto","fx","technical-analysis","screening","scanning","llm-tools"],"what_it_does":"Borsa MCP is a FastMCP-based remote/local MCP server that lets LLM agents query unified market and finance data for: BIST (stocks/indices), US stocks and indices (via Yahoo Finance), TEFAS funds, BtcTurk+Coinbase crypto markets, FX/commodities data, macro/TCMB data, KAP news, and provides helper tools like screeners/scanners and regulations. It exposes MCP tools to an agent through a server URL (remote) or via local installation/command.","use_cases":["LLM-assisted stock/fund/crypto research with tool-based data retrieval","Technical analysis and pivot point computation for tickers","Scanning/screening (preset filters) across BIST and US equities/ETFs/funds","Fetching macro events and TCMB-related inflation data","Summarizing KAP/company news by news_id","Education or prototyping for finance analytics workflows"],"not_for":["Automated investment advice or trading execution without human oversight","Guaranteeing accuracy of market data/financial conclusions","Compliance-critical financial reporting where audit trails and provenance are required"],"best_when":"You want an MCP toolset for agentic workflows that can retrieve and combine public market/financial data quickly (and you can validate results).","avoid_when":"You require strict guarantees about data provenance, legal/compliance controls, or deterministic accuracy; or you need guaranteed rate-limit behavior and robust error semantics not documented here.","alternatives":["Using direct upstream APIs (Yahoo Finance, TEFAS, KAP feeds, Coinbase/BtcTurk public APIs) with your own aggregation layer","Community MCP servers or frameworks with OpenAPI/SDK-first integrations","Building a REST wrapper around the MCP server for your agent tooling"],"af_score":61.8,"security_score":39.5,"reliability_score":31.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:27:13.616841+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"https://borsamcp.fastmcp.app/mcp","has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["No explicit auth described for the remote MCP endpoint in README; local mode described without credentials"],"oauth":false,"scopes":false,"notes":"README does not document API keys, OAuth, or scopes for the remote MCP URL. Local execution is possible via uvx, which implies no hosted auth but does not confirm credential handling for upstream data sources."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":["Claude Desktop usage requires a paid subscription (per README)."],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"The server is described as a 'Remote MCP' that 'Kurulum gerektirmez'; however, README only explicitly mentions that Claude Desktop requires a paid subscription. No pricing for the MCP service itself is provided."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":61.8,"security_score":39.5,"reliability_score":31.2,"mcp_server_quality":78.0,"documentation_accuracy":65.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":20.0,"tls_enforcement":60.0,"auth_strength":25.0,"scope_granularity":10.0,"dependency_hygiene":55.0,"secret_handling":55.0,"security_notes":"The remote MCP URL uses HTTPS (implying TLS in transit). No auth mechanism (API key/OAuth) is documented, so the hosted endpoint may be open; this lowers auth strength and scope granularity. The project depends on several third-party libraries (httpx, requests, yfinance, beautifulsoup4, pdfplumber, etc.); the README/manifest does not provide vulnerability status, so dependency hygiene is estimated. No explicit secret-handling practices are documented in the provided content.","uptime_documented":0.0,"version_stability":60.0,"breaking_changes_history":40.0,"error_recovery":25.0,"idempotency_support":"false","idempotency_notes":"Most tools appear to be read-only data fetches (e.g., get_historical_data, get_fund_data), which are typically idempotent, but the README does not explicitly state idempotency guarantees for MCP calls.","pagination_style":"offset/limit mentioned for US/BIST screeners","retry_guidance_documented":false,"known_agent_gotchas":["README warns that LLMs can hallucinate; agents should verify outputs.","Upstream sources (Yahoo/KAP/TEFAS/exchanges) may have rate limits or intermittent failures; README does not specify MCP error codes or retry guidance.","Potential data correctness issues (currency/timezone normalization, market holidays, partial coverage across tickers) are not clearly documented.","Remote MCP availability and performance are not described; long-running scans could time out depending on client timeouts."]}}