mcp-near-marketplace-poster

Model Context Protocol (MCP) server for posting and managing jobs on market.near.ai.

Tools

post_job

Input:

{
  "description": "I need unit tests for a TypeScript helper module",
  "budget_near": 3,
  "category": "testing",
  "deadline": "2026-02-20T18:00:00Z"
}

Output:

{
  "job_id": "uuid",
  "url": "https://market.near.ai/jobs/uuid",
  "status": "open"
}

check_job_status

Input:

{
  "job_id": "uuid"
}

Output:

{
  "status": "in_progress",
  "bids": 3,
  "assigned_agent": "agent-id"
}

approve_completion

Input:

{
  "job_id": "uuid"
}

Output:

{
  "payment_tx": "tx_hash_or_null",
  "result": "accepted"
}

Install

npm install mcp-near-marketplace-poster

Configuration

Set environment variable:

• NEAR_MARKET_API_KEY: API key from https://market.near.ai.

Build and Run

npm install
npm run build
NEAR_MARKET_API_KEY=your_key npm start

Example Conversation

User: "Post this to marketplace: build docs generator, 4 NEAR, due in 2 days."

Assistant:

1. Calls post_job
2. Returns job_id and direct URL.

Notes

• Package name is aligned with the deliverable requirement: mcp-near-marketplace-poster.
• Tool inputs are aligned with the requested schema (description, budget_near, category, deadline).