{"id":26748609,"url":"https://github.com/noveum/api-market-mcp-server","last_synced_at":"2026-08-27T15:58:38.149Z","repository":{"id":284602094,"uuid":"945798160","full_name":"Noveum/api-market-mcp-server","owner":"Noveum","description":"API Market MCP Servers","archived":false,"fork":false,"pushed_at":"2025-04-01T17:12:10.000Z","size":933,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-20T18:13:32.735Z","etag":null,"topics":["ai","ai-api","api","api-market","artificial-intelligence","mcp-server"],"latest_commit_sha":null,"homepage":"https://api.market","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Noveum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-03-10T06:24:23.000Z","updated_at":"2025-08-29T07:34:56.000Z","dependencies_parsed_at":"2025-06-17T13:10:42.522Z","dependency_job_id":"15477ad2-3948-47f4-aeb8-373b18585ccd","html_url":"https://github.com/Noveum/api-market-mcp-server","commit_stats":null,"previous_names":["noveum/api-market-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Noveum/api-market-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Noveum%2Fapi-market-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Noveum%2Fapi-market-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Noveum%2Fapi-market-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Noveum%2Fapi-market-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Noveum","download_url":"https://codeload.github.com/Noveum/api-market-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Noveum%2Fapi-market-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36944064,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-22T15:14:58.755Z","status":"online","status_checked_at":"2026-08-27T02:00:07.166Z","response_time":96,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ai","ai-api","api","api-market","artificial-intelligence","mcp-server"],"created_at":"2025-03-28T10:19:04.691Z","updated_at":"2026-08-27T15:58:37.698Z","avatar_url":"https://github.com/Noveum.png","language":"TypeScript","funding_links":[],"categories":["Aggregators"],"sub_categories":["How to Submit"],"readme":"# API-MARKET MCP Server\n\n## About\nA Model Context Protocol (MCP) server that exposes API-Market's endpoints as MCP resources. This server allows Large Language Models to discover and interact with APIs defined by OpenAPI specifications through the MCP protocol.  \nThis repository provides access to the APIs available at [API.market](https://api.market/). The tool is free to use and allows agents to communicate freely with all available APIs, making it super powerful. With over **200+ APIs** available at [API.market](https://api.market/), you can leverage a wide range of functionalities.\n\n## Quick Start\n\nYou do not need to clone this repository to use this MCP server. You can simply configure it in your client of choice.\n\n### For Claude Desktop\n1. Locate or create your Claude Desktop configuration file:\n   - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n2. Add the following configuration to enable the API-Market MCP server:\n   ```json\n   {\n     \"mcpServers\": {\n       \"api-market\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@noveum-ai/mcp-server\"],\n         \"env\": {\n           \"API_HEADERS\": \"x-magicapi-key:your-api-key\"\n         }\n       }\n     }\n   }\n   ```\n### For Cursor\n1. Go to File -\u003e Preferences -\u003e Cursor Settings.\n2. Select MCP.\n3. Click on Add new global MCP Server.\n4. Paste the following into the mcp.json file.\n\n```json\n  {\n    \"mcpServers\": {\n      \"api-market\": {\n        \"command\": \"npx\",\n        \"args\": [\n          \"-y\",\n          \"@noveum-ai/mcp-server\",\n          \"--headers\",\n          \"x-magicapi-key:\u003cyour-api-key\u003e\"\n        ]\n      }\n    }\n  }\n```\nAlternatively, add this as the first entry in mcpServers.\n```json  \n    \"api-market\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@noveum-ai/mcp-server\",\n        \"--headers\",\n        \"x-magicapi-key:\u003cyour-api-key\u003e\"\n      ]\n    },\n```\n5. For older versions of Cursor, add the following command after clicking on Add new MCP server \n```bash\nnpx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key\n```\n## Getting an API Key from API.market\n\n To obtain an API key\n 1. Log in to [API.market](https://api.market/)\n 2. Go to your profile and select 'My API Keys'\n 3. Your API keys will be displayed here\n\n## List of APIs in this MCP\n\n- [GET-trueway-matrix-MatrixService-CalculateDrivingMatrix](https://api.market/store/trueway/matrix)\n- [GET-magicapi-whisper-predictions--request_id](https://api.market/store/magicapi/whisper)\n- [POST-magicapi-whisper-whisper](https://api.market/store/magicapi/whisper)\n- [POST-capix-faceswap-upload](https://api.market/store/capix/faceswap)\n- [POST-capix-faceswap-faceswap-v1-image](https://api.market/store/capix/faceswap)\n- [POST-capix-faceswap-faceswap-v1-video](https://api.market/store/capix/faceswap)\n- [POST-capix-faceswap-result](https://api.market/store/capix/faceswap)\n- [GET-trueway-geocoding-GeocodingService-Geocode](https://api.market/store/trueway/geocoding)\n- [GET-trueway-geocoding-GeocodingService-ReverseGeocode](https://api.market/store/trueway/geocoding)\n- [POST-magicapi-dnschecker-dnschecker](https://api.market/store/magicapi/dnschecker)\n- [GET-magicapi-coder-predictions--request_id](https://api.market/store/magicapi/coder)\n- [POST-magicapi-coder-coder](https://api.market/store/magicapi/coder)\n- [POST-bridgeml-nsfw-detection-nsfw_detection](https://api.market/store/bridgeml/nsfw)\n- [GET-magicapi-whois-whois--domain-](https://api.market/store/magicapi/whois)\n- [GET-magicapi-deblurer-predictions--request_id](https://api.market/store/magicapi/deblurer)\n- [POST-magicapi-deblurer-deblurer](https://api.market/store/magicapi/deblurer)\n- [POST-bridgeml-text-to-image-text_to_image](https://api.market/store/bridgeml/text)\n- [GET-magicapi-period-predictions--request_id](https://api.market/store/magicapi/period)\n- [POST-magicapi-period-period](https://api.market/store/magicapi/period)\n- [GET-trueway-places-PlacesService-FindPlaceByText](https://api.market/store/trueway/places)\n- [GET-trueway-places-PlacesService-FindPlacesNearby](https://api.market/store/trueway/places)\n- [GET-magicapi-hair-predictions--request_id](https://api.market/store/magicapi/hair)\n- [POST-magicapi-hair-hair](https://api.market/store/magicapi/hair)\n- [POST-bridgeml-codellama-bridgeml-codellama](https://api.market/store/bridgeml/codellama)\n- [GET-brave-brave-videos-search](https://api.market/store/brave/brave)\n- [GET-brave-brave-web-search](https://api.market/store/brave/brave)\n- [GET-brave-brave-images-search](https://api.market/store/brave/brave)\n- [GET-brave-brave-news-search](https://api.market/store/brave/brave)\n- [GET-brave-brave-suggest-search](https://api.market/store/brave/brave)\n- [GET-brave-brave-spellcheck-search](https://api.market/store/brave/brave)\n- [POST-magicapi-domainchecker-check_domains](https://api.market/store/magicapi/domainchecker)\n- [GET-trueway-routing-DirectionsService-FindDrivingRoute](https://api.market/store/trueway/routing)\n- [GET-trueway-routing-DirectionsService-FindDrivingPath](https://api.market/store/trueway/routing)\n- [POST-pipfeed-parse-extract](https://api.market/store/pipfeed/parse)\n\n## Example and Usage\n### Example 1\nWe can use the agent to find a route between any two points\n\n![Example 1](./images/example1.png \"Example 1\")\n\n### Example 2\nWe can use the agent to find news about any topic, and then dig deeper into the articles\n\n![Example 2.1](./images/example2.1.png \"Example 2.1\")\n![Example 2.2](./images/example2.2.png \"Example 2.2\")\n\n### Example 3\nWe can use the agent to look for available domains\n\n![Example 3](./images/example3.png \"Example 3\")\n\n## Development\n\n### Adding a New API to the MCP Server\n\nThe `utils` folder contains helper scripts for managing API configurations, parsing OpenAPI specifications, and registering new APIs into the MCP server.\n\n#### 1. Locate the OpenAPI Specification\nFind the OpenAPI JSON for the API you want to integrate. After that, create a folder `json_files` in the root directory of the project and add your OpenAPI JSON spec to the folder\n\n#### 2. Modify the OpenAPI Specification\nAfter obtaining the OpenAPI spec, use `modify_api.py` to update the path inside the spec to include the file name.\n\n```bash\npython utils/modify_api.py\n```\n\n#### 3. Update API Summaries\nAfter modifying the paths, update the API summaries by choosing one of the following options:\n\n- **Automatically shorten summaries using an LLM:**\n\n```bash\npython utils/LLM_summary_shortener.py \n```\n\n- **Manually update the summaries:**\n\n```bash\npython utils/manual_summary_shortener.py \n```\n\n#### 4. Build and Test\n\nRebuild the project to apply the changes:\n\n```bash\nnpm run build\n```\n\nThen, test the new API integration using:\n\n```bash\nnpm run inspect\n```\n\n#### 5. Submit Your Changes\nIf you want to contribute this new API to the repository:\n- Fork the repo.\n- Create a branch.\n- Submit a pull request (PR).\n\n#### 6. Publish the MCP server (Optional)\nIf you want to publish your changes:\n- Update the `package.json` accordingly (e.g., update the version, name, etc.).\n- Publish the package:\n```bash\nnpm publish --access public\n```\n\n## Development Tools\n\n### Building\n- `npm run build` - Builds the TypeScript source.\n- `npm run clean` - Removes build artifacts.\n- `npm run typecheck` - Runs TypeScript type checking.\n\n### Development Mode\n- `npm run dev` - Watches source files and rebuilds on changes.\n- `npm run inspect-watch` - Runs the inspector with auto-reload on changes.\n\n### Code Quality\n- `npm run lint` - Runs ESLint.\n- `npm run typecheck` - Verifies TypeScript types.\n\n\u003c!-- ##### Set Environment Variables:\nConfigure your environment by running the following commands:\n```bash\nexport OPENAPI_SPEC_PATH=modified_files.txt # optional\nexport API_BASE_URL=https://api.magicapi.dev/api/v1/ # optional\nexport API_HEADERS=\"x-magicapi-key:your-api-key\"\n``` --\u003e\n\n#### Command Line Arguments\n```bash\nnpm run inspect -- \\\n  --api-base-url https://api.magicapi.dev/api/v1/ \\\n  --openapi-spec modified_files.txt \\\n  --headers \"x-magicapi-key:your-api-key\" \\\n  --name \"my-mcp-server\" \\\n  --version \"1.0.0\"\n```\n\n### Development Workflow\n1. Start the development environment:\n```bash\nnpm run inspect-watch\n```\n2. Modify the TypeScript files in `src/`.\n3. The server will automatically rebuild and restart.\n4. Use the MCP Inspector UI to test your changes.\n\n### Debugging or Running Locally\nTo debug or run the MCP server locally:\n1. Clone the repository and install dependencies:\n```bash\ngit clone https://github.com/Noveum/api-market-mcp-server.git\ncd api-market-mcp-server\nnpm install\n```\n2. Build the server:\n```bash\nnpm run build\n```\n3. For debugging, you can run:\n```bash\nnpm run inspect \n```\n\n### Contributing\n1. Fork the repository.\n2. Create a feature branch.\n3. Make your changes.\n4. Run tests and linting:\n```bash\nnpm run typecheck\nnpm run lint\n```\n5. Submit a pull request.\n\n### License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoveum%2Fapi-market-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoveum%2Fapi-market-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoveum%2Fapi-market-mcp-server/lists"}