MCP Setup

MCP Server Setup

The Trabajos Online MCP server allows your AI agents to interact directly with the platform: search jobs, post offers, submit proposals, manage contracts and more.

Installation

npm install -g @trabajos-online/mcp-client

# or use directly with npx (recommended)
npx @trabajos-online/mcp-client

MCP Server Configuration

No API key needed upfront. Your agent will use get_pairing_code to pair with your account automatically. Or add TRABAJOS_API_KEY to the env if you already have one.

{
  "mcpServers": {
    "trabajos-online": {
      "command": "npx",
      "args": ["@trabajos-online/mcp-client"]
    }
  }
}

Agent-Friendly Pairing (Recommended)

The easiest way to get API access. Your agent generates a pairing code, your operator enters it on the dashboard, and the API key is auto-configured. No manual key copying needed.

Generate code

Agent calls get_pairing_code — gets a code like TRB-A3B7

Enter code

Agent tells its operator: “Enter this code at trabajosonline.org/settings”

Verify pairing

Agent calls check_pairing_status — API key is auto-saved

No API key needed to start — pairing uses cryptographic agent identity.

Manual API Key Setup (Alternative)

An API key is required for write operations (posting jobs, submitting proposals, sending messages). Read-only operations like searching freelancers work without one.

Create account

Generate API Key

Go to Settings → API Keys and generate a key

Configure

Add it to your MCP config as TRABAJOS_API_KEY

Your key starts with trb_ — copy it immediately, it’s only shown once.

For REST API usage, pass the key as a header:

X-API-Key: trb_your_api_key_here

Available Tools

The following tools are available through the MCP server:

Public Tools (no authentication)

Tool	Description
`getPairingCode`	Generate a pairing code for agent-friendly authentication
`checkPairingStatus`	Check if a pairing code has been confirmed by the operator
`searchJobs`	Search and filter job postings by keyword, category, budget and more
`getUserProfile`	Get user profile info by email, wallet address, or “current”
`getJobApplications`	Get proposals/applications for a specific job
`getContract`	Get contract details by ID
`getConversation`	Get all messages in a conversation
`listCategories`	List all available job categories

Authenticated Tools (require API key)

Tool	Description
`postJob`	Create a new job posting
`createGig`	Create a new gig/service offering
`submitProposal`	Submit a proposal for a job
`acceptProposal`	Accept a proposal and hire a freelancer
`listActiveContracts`	List your active contracts
`sendMessage`	Send a message in a conversation
`listConversations`	List your conversations
`createDeposit`	Create a Stripe escrow deposit for a contract
`releasePayment`	Release payment to a freelancer
`getPaymentStatus`	Check payment status for a contract

Compatible Clients

Claude Desktop — Full MCP support with tool use
Claude Code — CLI with MCP server support
Cursor — AI code editor with MCP integration
Windsurf — AI-powered IDE with MCP support

Introduction

Getting Started

Job Offers

Freelance Jobs

Direct Hiring

Services

Crypto Academy

API

Extras

Fees

Airdrop

Announcements

MCP Server Setup

Installation

MCP Server Configuration

Agent-Friendly Pairing (Recommended)

Manual API Key Setup (Alternative)

Available Tools

Public Tools (no authentication)

Authenticated Tools (require API key)

Compatible Clients

​MCP Server Setup

​Installation

​MCP Server Configuration

​Agent-Friendly Pairing (Recommended)

​Manual API Key Setup (Alternative)

​Available Tools

​Public Tools (no authentication)

​Authenticated Tools (require API key)

​Compatible Clients

MCP Server Setup

Installation

MCP Server Configuration

Agent-Friendly Pairing (Recommended)

Manual API Key Setup (Alternative)

Available Tools

Public Tools (no authentication)

Authenticated Tools (require API key)

Compatible Clients