API-MARKET Service Broker (MCP Node)

Core Functionality

This service acts as a Model Context Protocol (MCP) intermediary, translating requests into interactions with the extensive collection of endpoints hosted on API.market, all documented via OpenAPI specifications. It grants Large Language Models the capability to dynamically discover and invoke these external operations.

The service offers access to a library exceeding 200 distinct APIs hosted at API.market. This integration provides agents with unprecedented access to a wide spectrum of capabilities at no direct cost for communication.

Deployment Instructions

Instantiation of this MCP node is straightforward and does not necessitate cloning the source repository. Configuration can be injected directly into compatible client environments.

Configuration for Claude Desktop

Modify your configuration file located at: - macOS path: ~/Library/Application Support/Claude/claude_desktop_config.json

Integrate the server definition as follows, ensuring you substitute <your-api-key>:

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

Configuration for Cursor IDE

Navigate to File -> Preferences -> Cursor Settings, select the MCP tab, and add a new global server configuration.

Paste the following JSON structure into the corresponding configuration file:

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

For older Cursor installations, the required command line invocation is:

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

Obtaining Credentials

Access keys are required to authorize interactions with the underlying endpoints: 1. Sign in at API.market. 2. Navigate to the user profile section and locate 'My API Keys'. 3. Your necessary credential will be displayed.

Integrated API Manifest

The following services are exposed via this MCP instance:

• Driving route calculation: [GET-trueway-matrix-MatrixService-CalculateDrivingMatrix]
• Speech-to-text processing: [GET-magicapi-whisper-predictions--request_id], [POST-magicapi-whisper-whisper]
• Image manipulation (face swapping): [POST-capix-faceswap-upload], [POST-capix-faceswap-faceswap-v1-image], [POST-capix-faceswap-faceswap-v1-video], [POST-capix-faceswap-result]
• Location services (geocoding/reverse geocoding): [GET-trueway-geocoding-GeocodingService-Geocode], [GET-trueway-geocoding-GeocodingService-ReverseGeocode]
• Domain status checks: [POST-magicapi-dnschecker-dnschecker]
• Code generation/prediction: [GET-magicapi-coder-predictions--request_id], [POST-magicapi-coder-coder]
• Content moderation: [POST-bridgeml-nsfw-detection-nsfw_detection]
• Domain lookup utility: [GET-magicapi-whois-whois--domain-]
• Image restoration: [GET-magicapi-deblurer-predictions--request_id], [POST-magicapi-deblurer-deblurer]
• Text-to-image synthesis: [POST-bridgeml-text-to-image-text_to_image]
• Period prediction: [GET-magicapi-period-predictions--request_id], [POST-magicapi-period-period]
• Local search and discovery: [GET-trueway-places-PlacesService-FindPlaceByText], [GET-trueway-places-PlacesService-FindPlacesNearby]
• Hair style prediction: [GET-magicapi-hair-predictions--request_id], [POST-magicapi-hair-hair]
• Code assistance model: [POST-bridgeml-codellama-bridgeml-codellama]
• Web search utilities (Brave integration): [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]
• Bulk domain validation: [POST-magicapi-domainchecker-check_domains]
• Route planning: [GET-trueway-routing-DirectionsService-FindDrivingRoute], [GET-trueway-routing-DirectionsService-FindDrivingPath]
• Feed parsing and extraction: [POST-pipfeed-parse-extract]

Operational Examples

Scenario 1: Pathfinding

Agents can compute navigation paths between distinct geographical coordinates.

Scenario 2: Information Retrieval

Agents can perform topical web searches, retrieve associated news articles, and subsequently analyze the content of those articles.

Scenario 3: Asset Availability Check

Agents can query the status and registration availability of specified internet domains.

Development & Contribution Guide

Integrating Novel Capabilities

Scripts within the utils directory assist in the lifecycle management of integrating new API definitions into the MCP service structure.

Step 1: Specification Acquisition

Acquire the target API's OpenAPI JSON definition. Place this file within a newly created json_files directory at the project root.

Step 2: Definition Path Adjustment

Execute modify_api.py to embed the necessary local file reference within the specification structure.

python utils/modify_api.py

Step 3: Abstracting Operation Descriptions

Refine the human-readable descriptions for the newly exposed endpoints. Options include:

• Automated Condensation (LLM-driven):

python utils/LLM_summary_shortener.py 

• Manual Revision:

python utils/manual_summary_shortener.py 

Step 4: Compilation and Verification

Recompile the service bundle to incorporate the modifications:

npm run build

Validate the functionality using the integrated inspection tool:

npm run inspect

Step 5: Submission Protocol

To contribute upstream: - Fork the repository instance. - Branch for your feature development. - Submit a Pull Request (PR) detailing the changes.

Step 6: Public Release (Optional)

To prepare the package for public npm distribution: - Update metadata in package.json (version, name adjustments). - Execute the publication command:

npm publish --access public

Toolchain Commands

Build Utilities

• npm run build: Compiles TypeScript source files.
• npm run clean: Purges generated build output.
• npm run typecheck: Validates static type consistency.

Development Lifecycle

• npm run dev: Initiates file monitoring and incremental rebuilding.
• npm run inspect-watch: Launches the inspector utility with live reloading enabled.

Code Quality Assurance

• npm run lint: Executes ESLint checks.
• npm run typecheck: Confirms TypeScript compliance.

Runtime Argument Configuration Example

When invoking the inspector, custom parameters can be passed:

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"

Local Execution & Debugging

To set up and run the server in a local development context: 1. Clone and initialize dependencies:

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

1. Compile the binary:

npm run build

1. Launch for debugging or direct use:

npm run inspect 

Contribution Guidelines Summary

1. Fork the primary repository.
2. Establish a dedicated feature branch.
3. Implement necessary modifications.
4. Validate integrity via testing and linting:

npm run typecheck
npm run lint

1. Submit your feature branch as a PR.

Licensing

Proprietary license governed by MIT terms.

---

Contextual Note: Business management tools encompass methodologies, controls, and applications intended to equip organizations for navigating evolving market dynamics, maintaining competitive standing, and optimizing operational effectiveness. These tools span departmental functions such as planning, process control, record-keeping, decision support, and workforce management. Modern business software, progressing from basic MIS to comprehensive ERP and cloud solutions, demands strategic selection and organizational alignment to maximize value realization.