API-MARKET MCP Server

by MCP-Mirror

358 downloads Not rated yet MIT license

About

A Model Context Protocol (MCP) server that exposes API-Market's endpoints as MCP resources, allowing Large Language Models to discover and interact with over 200+ APIs defined by OpenAPI specifications. It is free to use and connects to APIs available at API.market.

Details

License
MIT license

Explore

- Exposes API.market endpoints as MCP resources for LLMs.
- Supports over 200+ APIs across multiple domains.
- Free to use with an API key from API.market.
- Runs via npx with no local clone required.
- Includes helper scripts for adding new APIs.
- Open source and accepts community contributions.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name API-MARKET MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

You do not need to clone this repository to use this MCP server. You can simply configure it in your client of choice.

To obtain an API key
1. Log in to API.market
2. Go to your profile and select 'My API Keys'
3. Your API keys will be displayed here

To debug or run the MCP server locally:
1. Clone the repository and install dependencies:

git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install

2. Build the server:
npm run build

3. For debugging, you can run:
npm run inspect 

distance_and_duration_bw_starts_and_stops

Calculate length and driving time of the optimal routes between origin and destination points on the real road network.

Get_audio_analysis_URL

This endpoint retrieves the URL of the transcription and analysis of the audio for the given request ID.

Whisper_Audio_Processing

API for sentece wise transcription and analysis of audio, using AI models. Make sure to call get audio analysis URL with the request ID received from this API.

Upload

Make a POST request to capix/faceswap/upload/

ImageFaceSwap

Make a POST request to capix/faceswap/faceswap/v1/image

VideoFaceSwap

Make a POST request to capix/faceswap/faceswap/v1/video

Result

Make a POST request to capix/faceswap/result/

Forward_Geocoding

Obtain location(geographic coordinates) for address.

Reverse_Geocoding

Obtain address for location.

DNS_Checker_API

Make a POST request to magicapi/dnschecker/dnschecker

Get_coder_output_URL

This endpoint retrieves the URL of the coding assistant's response for a given request ID.

Coding_Assistant

Coding Assistant. Make sure you call get coder output URL MCP tool to get the URL for the request id received from this API

A_fast_nsfw_detection_API

Make a POST request to bridgeml/nsfw!detection/nsfw_detection

getWhoisInfo

Make a GET request to magicapi/whois/whois/{domain}

Get_Unblurred_Image_URL

This endpoint retrieves the URL of the Unblurred image for a given request ID.

Deblurer

API for image deblurring. Make sure you call get deblurred image URL, MCP tool to get the URL for the request id received from this API

text-to-image

Make a POST request to bridgeml/text!to!image/text_to_image

Get_ageing_gif_URL

This endpoint retrieves the URL of the ageing gif for a given request ID.

Period_changer

API for generating ageing gif using AI models. Make sure to call get ageing gif URL, with the result id received from this API

Search_for_places_by_text

Search for places by text string

Search_for_nearby_places

Search for places around location within a specified radius.

Get_hairstyled_image_URL

This endpoint retrieves the URL of the simulated hairstyle image for a given request ID.

Hair_style_simulator

API for simulating different hair styles using AI models. Make sure to call get hairstyled image after with the request id received from this API.

BridgeML_API

Make a POST request to bridgeml/codellama/bridgeml/codellama

Search_Videos

Retrieve video search results based on query parameters

Search_Web

Retrieve web search results based on query parameters

Search_Images

Retrieve image search results based on query parameters

Search_News

Retrieve news search results based on query parameters

Search_Suggestions

Retrieve search suggestions based on query parameters

Spellcheck_Search

Retrieve spellcheck suggestions based on query parameters

Check_domain_availability

Submit a domain name to check its availability.

best_route_for_multiple_stops

Finding optimal route to visit several locations.

best_route_bw_start_and_stop

Finding optimal route from a origin to a destination, passing through multiple waypoints(optional).

Extract_information_from_a_URL

Make a POST request to pipfeed/parse/extract

- distance_and_duration_bw_starts_and_stops: Calculate length and driving time of the optimal routes between origin and destination points on the real road network.
- Get_audio_analysis_URL: This endpoint retrieves the URL of the transcription and analysis of the audio for the given request ID.
- Whisper_Audio_Processing: API for sentece wise transcription and analysis of audio, using AI models. Make sure to call get audio analysis URL with the request ID received from this API.
- Upload: Make a POST request to capix/faceswap/upload/
- ImageFaceSwap: Make a POST request to capix/faceswap/faceswap/v1/image
- VideoFaceSwap: Make a POST request to capix/faceswap/faceswap/v1/video
- Result: Make a POST request to capix/faceswap/result/
- Forward_Geocoding: Obtain location(geographic coordinates) for address.
- Reverse_Geocoding: Obtain address for location.
- DNS_Checker_API: Make a POST request to magicapi/dnschecker/dnschecker
- Get_coder_output_URL: This endpoint retrieves the URL of the coding assistant's response for a given request ID.
- Coding_Assistant: Coding Assistant.
Make sure you call get coder output URL MCP tool to get the URL for the request id received from this API
- A_fast_nsfw_detection_API: Make a POST request to bridgeml/nsfw!detection/nsfw_detection
- getWhoisInfo: Make a GET request to magicapi/whois/whois/{domain}
- Get_Unblurred_Image_URL: This endpoint retrieves the URL of the Unblurred image for a given request ID.
- Deblurer: API for image deblurring.
Make sure you call get deblurred image URL, MCP tool to get the URL for the request id received from this API
- text-to-image: Make a POST request to bridgeml/text!to!image/text_to_image
- Get_ageing_gif_URL: This endpoint retrieves the URL of the ageing gif for a given request ID.
- Period_changer: API for generating ageing gif using AI models. Make sure to call get ageing gif URL, with the result id received from this API
- Search_for_places_by_text: Search for places by text string
- Search_for_nearby_places: Search for places around location within a specified radius.
- Get_hairstyled_image_URL: This endpoint retrieves the URL of the simulated hairstyle image for a given request ID.
- Hair_style_simulator: API for simulating different hair styles using AI models. Make sure to call get hairstyled image after with the request id received from this API.
- BridgeML_API: Make a POST request to bridgeml/codellama/bridgeml/codellama
- Search_Videos: Retrieve video search results based on query parameters
- Search_Web: Retrieve web search results based on query parameters
- Search_Images: Retrieve image search results based on query parameters
- Search_News: Retrieve news search results based on query parameters
- Search_Suggestions: Retrieve search suggestions based on query parameters
- Spellcheck_Search: Retrieve spellcheck suggestions based on query parameters
- Check_domain_availability: Submit a domain name to check its availability.
- best_route_for_multiple_stops: Finding optimal route to visit several locations.
- best_route_bw_start_and_stop: Finding optimal route from a origin to a destination, passing through multiple waypoints(optional).
- Extract_information_from_a_URL: Make a POST request to pipfeed/parse/extract

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "api-market mcp server": {
            "Noveum_api-market-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@noveum-ai/mcp-server",
                    "--headers",
                    "x-magicapi-key:your-api-key"
                ]
            }
        }
    }
}

McpServers

{
    "Noveum_api-market-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "@noveum-ai/mcp-server",
            "--headers",
            "x-magicapi-key:your-api-key"
        ]
    }
}

About

A 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. This repository provides access to the APIs available at 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, you can leverage a wide range of functionalities.

Quick Start

You do not need to clone this repository to use this MCP server. You can simply configure it in your client of choice.

For Claude Desktop

1. Locate or create your Claude Desktop configuration file: - On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 2. Add the following configuration to enable the API-Market MCP server:
   {
     "mcpServers": {
       "api-market": {
         "command": "npx",
         "args": ["-y", "@noveum-ai/mcp-server"],
         "env": {
           "API_HEADERS": "x-magicapi-key:your-api-key"
         }
       }
     }
   }
   

For Cursor

1. Go to File -> Preferences -> Cursor Settings. 2. Select MCP. 3. Click on Add new global MCP Server. 4. Paste the following into the mcp.json file.
  {
    "mcpServers": {
      "api-market": {
        "command": "npx",
        "args": [
          "-y",
          "@noveum-ai/mcp-server",
          "--headers",
          "x-magicapi-key:<your-api-key>"
        ]
      }
    }
  }
Alternatively, add this as the first entry in mcpServers. ``json "api-market": { "command": "npx", "args": [ "-y", "@noveum-ai/mcp-server", "--headers", "x-magicapi-key:<your-api-key>" ] },
5. For older versions of Cursor, add the following command after clicking on Add new MCP server 
bash npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key
## Getting an API Key from API.market

To obtain an API key
1. Log in to API.market
2. Go to your profile and select 'My API Keys'
3. Your API keys will be displayed here

List of APIs in this MCP

- GET-trueway-matrix-MatrixService-CalculateDrivingMatrix
- GET-magicapi-whisper-predictions--request_id
- POST-magicapi-whisper-whisper
- POST-capix-faceswap-upload
- POST-capix-faceswap-faceswap-v1-image
- POST-capix-faceswap-faceswap-v1-video
- POST-capix-faceswap-result
- GET-trueway-geocoding-GeocodingService-Geocode
- GET-trueway-geocoding-GeocodingService-ReverseGeocode
- POST-magicapi-dnschecker-dnschecker
- GET-magicapi-coder-predictions--request_id
- POST-magicapi-coder-coder
- POST-bridgeml-nsfw-detection-nsfw_detection
- GET-magicapi-whois-whois--domain-
- GET-magicapi-deblurer-predictions--request_id
- POST-magicapi-deblurer-deblurer
- POST-bridgeml-text-to-image-text_to_image
- GET-magicapi-period-predictions--request_id
- POST-magicapi-period-period
- GET-trueway-places-PlacesService-FindPlaceByText
- GET-trueway-places-PlacesService-FindPlacesNearby
- GET-magicapi-hair-predictions--request_id
- POST-magicapi-hair-hair
- POST-bridgeml-codellama-bridgeml-codellama
- GET-brave-brave-videos-search
- GET-brave-brave-web-search
- GET-brave-brave-images-search
- GET-brave-brave-news-search
- GET-brave-brave-suggest-search
- GET-brave-brave-spellcheck-search
- POST-magicapi-domainchecker-check_domains
- GET-trueway-routing-DirectionsService-FindDrivingRoute
- GET-trueway-routing-DirectionsService-FindDrivingPath
- POST-pipfeed-parse-extract

Example and Usage

Example 1

We can use the agent to find a route between any two points

Example 1

Example 2

We can use the agent to find news about any topic, and then dig deeper into the articles

Example 2.1
Example 2.2

Example 3

We can use the agent to look for available domains

Example 3

Development

Adding a New API to the MCP Server

The utils folder contains helper scripts for managing API configurations, parsing OpenAPI specifications, and registering new APIs into the MCP server.

1. Locate the OpenAPI Specification
Find 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
2. Modify the OpenAPI Specification
After obtaining the OpenAPI spec, use
modify_api.py to update the path inside the spec to include the file name.

bash
python utils/modify_api.py

3. Update API Summaries

After modifying the paths, update the API summaries by choosing one of the following options:

- Automatically shorten summaries using an LLM:

bash
python utils/LLM_summary_shortener.py

- Manually update the summaries:

bash
python utils/manual_summary_shortener.py

4. Build and Test

Rebuild the project to apply the changes:

bash
npm run build

Then, test the new API integration using:

bash
npm run inspect

5. Submit Your Changes

If you want to contribute this new API to the repository:
- Fork the repo.
- Create a branch.
- Submit a pull request (PR).

6. Publish the MCP server (Optional)
If you want to publish your changes: - Update the
package.json accordingly (e.g., update the version, name, etc.). - Publish the package:
bash npm publish --access public

Development Tools

Building

-
npm run build - Builds the TypeScript source. - npm run clean - Removes build artifacts. - npm run typecheck - Runs TypeScript type checking.

Development Mode

-
npm run dev - Watches source files and rebuilds on changes. - npm run inspect-watch - Runs the inspector with auto-reload on changes.

Code Quality

-
npm run lint - Runs ESLint. - npm run typecheck - Verifies TypeScript types.

<!-- ##### Set Environment Variables:
Configure your environment by running the following commands:

bash
export OPENAPI_SPEC_PATH=modified_files.txt # optional
export API_BASE_URL=https://api.magicapi.dev/api/v1/ # optional
export API_HEADERS="x-magicapi-key:your-api-key"
` -->

Command Line Arguments
npm run inspect -- \
  --api-base-url https://api.magicapi.dev/api/v1/ \
  --openapi-spec modified_files.txt \
  --headers "x-magicapi-key:your-api-key" \
  --name "my-mcp-server" \
  --version "1.0.0"

Development Workflow

1. Start the development environment:
npm run inspect-watch
2. Modify the TypeScript files in
src/`. 3. The server will automatically rebuild and restart. 4. Use the MCP Inspector UI to test your changes.

Debugging or Running Locally

To debug or run the MCP server locally: 1. Clone the repository and install dependencies:
git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install
2. Build the server:
npm run build
3. For debugging, you can run:
npm run inspect 

Contributing

1. Fork the repository. 2. Create a feature branch. 3. Make your changes. 4. Run tests and linting:
npm run typecheck
npm run lint
5. Submit a pull request.

License

MIT
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.