API.Market Centralized Protocol Server

Overview

This implementation functions as a Model Context Protocol (MCP) endpoint, effectively wrapping the remote capabilities accessible via API.Market as local MCP resources. It empowers Large Language Models (LLMs) to dynamically ascertain and invoke external APIs documented via OpenAPI specifications utilizing the MCP framework.

Access to the functionalities curated at API.market is mediated by this tool. It operates without charge, granting agents unrestricted transactional access to the entire suite of published APIs, representing a significant augmentation of capabilities. With over 200 distinct services accessible through API.market, users can harness a multitude of complex operations.

Initialization Guide

Cloning this repository is unnecessary for immediate utilization of this MCP server. Configuration can be integrated directly into your preferred client application settings.

For Claude Desktop Users

1. Locate or generate your Claude Desktop configuration file, typically found at:
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Embed the subsequent configuration block to activate the API-Market MCP provider: json { "mcpServers": { "api-market": { "command": "npx", "args": ["-y", "@noveum-ai/mcp-server"], "env": { "API_HEADERS": "x-magicapi-key:your-api-key" } } } }

For Cursor Users

1. Navigate to File -> Preferences -> Cursor Settings.
2. Select the MCP configuration tab.
3. Choose the option to Add new global MCP Server.
4. Insert the following JSON structure into the mcp.json file:

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

Alternatively, prepend this entry to the existing mcpServers object:

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

1. On antecedent versions of Cursor, employ this command line invocation after selecting Add new MCP server:

npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

Acquiring an Authorization Token from API.market

To secure the necessary API credentials: 1. Authenticate at API.market 2. Access your user profile section and navigate to 'My API Keys' 3. Your credentials will be presented there.

Catalog of Services within 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

Illustrative Use Cases

Scenario 1

An agent can calculate an optimal route connecting two specified geographical locations.

Scenario 2

An agent can perform a topical web search for current events and subsequently analyze the corresponding article content in depth.

Scenario 3

An agent is equipped to query the availability status of specified internet domain names.

Contribution and Maintenance

Integrating Novel APIs into the MCP Server

Utility scripts located within the utils directory assist in managing API definitions, processing OpenAPI specifications, and formally registering new endpoints within the MCP framework.

1. Obtain the OpenAPI Specification Document

Secure the OpenAPI JSON file for the desired API. Subsequently, establish a directory named json_files in the project root and deposit the specification document there.

2. Schema Modification

After acquiring the OpenAPI definition, execute modify_api.py to update internal paths to reference the newly added filename.

python utils/modify_api.py

3. Refinement of Service Descriptions

Following path adjustments, summaries must be updated. Select one of the following automated or manual refinement methods:

• LLM-Assisted Summary Condensation:

python utils/LLM_summary_shortener.py 

• Manual Summary Revision:

python utils/manual_summary_shortener.py 

4. Compilation and Validation

Recompile the application to integrate the modifications:

npm run build

Subsequently, validate the new service integration:

npm run inspect

5. Submitting Revisions

To contribute your integration back to this repository: - Initiate a fork of the repository. - Establish a dedicated feature branch. - Commit your modifications. - Submit a formal Pull Request (PR).

6. MCP Server Deployment (Optional)

If you intend to publish your modifications: - Update package.json (e.g., version incrementation, name adjustments). - Execute the publishing command:

npm publish --access public

Auxiliary Development Utilities

Build Processes

• npm run build - Compiles the TypeScript source code.
• npm run clean - Erases generated build outputs.
• npm run typecheck - Executes comprehensive TypeScript type verification.

Iterative Development Mode

• npm run dev - Monitors source files for changes and triggers incremental rebuilds.
• npm run inspect-watch - Initiates the inspector utility with automatic reloading upon file modifications.

Code Integrity Checks

• npm run lint - Executes ESLint for style and error detection.
• npm run typecheck - Confirms TypeScript type correctness.