{"id":26648450,"url":"https://github.com/longmans/coin_api_mcp","last_synced_at":"2025-03-25T00:02:10.409Z","repository":{"id":270860651,"uuid":"903449956","full_name":"longmans/coin_api_mcp","owner":"longmans","description":"A Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data. This server enables AI-powered applications to retrieve cryptocurrency listings, quotes, and detailed information about various coins.","archived":false,"fork":false,"pushed_at":"2025-02-14T15:00:05.000Z","size":17,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T16:21:20.983Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/longmans.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-14T16:29:01.000Z","updated_at":"2025-02-14T15:00:10.000Z","dependencies_parsed_at":"2025-01-03T16:47:33.982Z","dependency_job_id":"4e968560-b33b-47e8-854d-aefe1a0a16f9","html_url":"https://github.com/longmans/coin_api_mcp","commit_stats":null,"previous_names":["longmans/coin_api_mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longmans%2Fcoin_api_mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longmans%2Fcoin_api_mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longmans%2Fcoin_api_mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longmans%2Fcoin_api_mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/longmans","download_url":"https://codeload.github.com/longmans/coin_api_mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245372379,"owners_count":20604491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-25T00:01:58.410Z","updated_at":"2025-03-25T00:02:10.305Z","avatar_url":"https://github.com/longmans.png","language":"Python","readme":"# Coin MCP Server\n\n[![smithery badge](https://smithery.ai/badge/coin-api-mcp)](https://smithery.ai/server/coin-api-mcp)\n\nA Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data. This server enables AI-powered applications to retrieve cryptocurrency listings, quotes, and detailed information about various coins.\n\n### Available Tools\n\n- `listing-coins` - Fetches a paginated list of all active cryptocurrencies with the latest market data.\n    - `start` (integer, optional): Offset the start (1-based index) of the paginated list of items to return.\n    - `limit` (integer, optional): Number of results to return (default: 10, max: 5000).\n    - `price_min` (number, optional): Minimum USD price to filter results.\n    - `price_max` (number, optional): Maximum USD price to filter results.\n    - `market_cap_min` (number, optional): Minimum market cap to filter results.\n    - `market_cap_max` (number, optional): Maximum market cap to filter results.\n    - `convert` (string, optional): Calculate market quotes in multiple currencies.\n    - `sort` (string, optional): Field to sort the list of cryptocurrencies by.\n    - `sort_dir` (string, optional): Direction to order cryptocurrencies (asc or desc).\n\n- `get-coin-info` - Retrieves detailed information about a specific cryptocurrency.\n    - `id` (string, optional): One or more comma-separated CoinMarketCap cryptocurrency IDs.\n    - `slug` (string, optional): A comma-separated list of cryptocurrency slugs.\n    - `symbol` (string, optional): One or more comma-separated cryptocurrency symbols.\n\n- `get-coin-quotes` - Fetches the latest market quotes for one or more cryptocurrencies.\n    - `id` (string, optional): One or more comma-separated cryptocurrency CoinMarketCap IDs.\n    - `slug` (string, optional): A comma-separated list of cryptocurrency slugs.\n    - `symbol` (string, optional): One or more comma-separated cryptocurrency symbols.\n\n## Installation\n\n### Installing via Smithery\n\nTo install Cryptocurrency Data for Claude Desktop automatically via [Smithery](https://smithery.ai/server/coin-api-mcp):\n\n```bash\nnpx -y @smithery/cli install coin-api-mcp --client claude\n```\n\n### Build the Server\nClone this repository and build and install the program with your default Python interpreter (recommended).\n\n```bash\ngit clone https://github.com/longmans/coin_api_mcp.git\ncd coin_api_mcp\nuv build\nuv pip install .\n```\n\nAfter installation, you can run it as a script using:\n\n```bash \npython -m coin_api_mcp\n```\n\n\n\n## Configuration\n\n### API Key\n\nThe server requires a CoinMarketCap API key to function. You can obtain one from [CoinMarketCap's website](https://coinmarketcap.com/api/). The API key can be provided in two ways:\n\n1. As an environment variable:\n```bash\nexport COINMARKETCAP_API_KEY=your_api_key_here\n```\n\n2. As a command-line argument:\n```bash\npython -m coin_api_mcp --api-key=your_api_key_here\n```\n\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\n\u003cdetails\u003e\n\u003csummary\u003eUsing pip installation\u003c/summary\u003e\n\n```json\n\"mcpServers\": {\n  \"coin_api\": {\n    \"command\": \"python\",\n    \"args\": [\"-m\", \"coin_api_mcp\"]\n  },\n  \"env\": {\n        \"COINMARKETCAP_API_KEY\": \"your_api_key_here\"\n  }\n}\n```\n\u003c/details\u003e\n\nIf you see any issue, you may want to use the full path for the Python interpreter you are using. You can do a `which python` to find out the exact path if needed.\n\nRemember to set the COINMARKETCAP_API_KEY environment variable or provide it via the --api-key argument.\n\n\n## Debugging\n\nYou can use the MCP inspector to debug the server\n\n\n## Contributing\n\nWe encourage contributions to help expand and improve Coin MCP Server. Whether you want to add new search capabilities, enhance existing functionality, or improve documentation, your input is valuable.\n\nFor examples of other MCP servers and implementation patterns, see:\nhttps://github.com/modelcontextprotocol/servers\n\nPull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make Coin MCP Server even more powerful and useful.\n\n## License\n\nCoin MCP Server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.","funding_links":[],"categories":["Finance","📚 Projects (1974 total)","Community Servers","🤖 AI/ML","Server Implementations","Finance \u0026 Fintech","APIs and HTTP Requests","Mcp Server Directories \u0026 Lists","Table of Contents","🗂️ Extensions by Category"],"sub_categories":["Crypto \u0026 Blockchain","MCP Servers","AI Services","💰 Finance"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flongmans%2Fcoin_api_mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flongmans%2Fcoin_api_mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flongmans%2Fcoin_api_mcp/lists"}