MCP Setup

MCP Integration

Connect your AI agent to Trabajos Online using the Model Context Protocol. For direct REST API access, see the API docs.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude, ChatGPT, and others to interact with external services. With Trabajos Online’s MCP server, your AI agent can search freelancers, browse jobs, create gigs, and manage contracts — all through natural language.

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

What you can do

Two roles, one connector. Here is what the agent unlocks for each, and what both share.

Client

You hire someoneDashboard & overview — Active contracts, jobs you posted and unread messages in one call. getDashboardFind talent and services — Search people by skill, city and hourly rate, or packages with a fixed price. searchFreelancers · searchGigs · getUserProfilePost and manage jobs — Draft a posting from a short brief and publish it. Freelance postings are free. postJob · listCategoriesReview proposals and hire — Read the proposals a posting received and accept one to start the contract. getJobApplications · acceptProposalPayments you approve — The agent prepares the deposit or the release and hands you a link. Nothing moves without your confirmation. createDeposit · releasePayment · checkPaymentConfirmation · getPaymentStatus

Freelancer

You do the workDashboard & overview — Active contracts, proposals sent and unread messages in one call. getDashboardFind the right jobs — Search by keyword, category, budget, location and salary range. searchJobs · listCategoriesDraft and submit proposals — Write your proposal with budget and delivery time, and submit it. submitProposalSell service packages — Publish a gig with its packages, price and delivery time so clients can buy directly. createGigContracts and payment status — Follow your contracts and check whether a payment is deposited or released. listActiveContracts · getContract · getPaymentStatus

Shared by both

Area	What you can do	Tools
Messaging	Read your conversations and reply without leaving the agent	`listConversations` · `getConversation` · `sendMessage`
Account and access	Pair the agent with your account without handling an API key by hand, and read your profile	`getPairingCode` · `checkPairingStatus` · `getUserProfile`

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
`searchFreelancers`	Search people by skill, city, country and hourly rate
`searchGigs`	Search services with a fixed price and delivery time
`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

Which search do I use?

searchFreelancers → finds people. Tells you who you can hire and what they charge per hour.
searchGigs → finds ready-made services, with a set price and delivery date. Like buying a product.

Authenticated Tools (require API key)

Tool	Description
`getDashboard`	One-call account summary: active contracts, proposals sent, jobs posted and unread messages
`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`	Drafts an escrow deposit. Charges nothing: returns a confirmation link
`releasePayment`	Drafts a payment release. Moves no funds: returns a confirmation link
`checkPaymentConfirmation`	Check whether a drafted financial action has been confirmed
`getPaymentStatus`	Check payment status for a contract

The agent never moves your money

The agent asks. You approve. Just like paying online and your bank asking you to confirm on your phone: the shop requests the charge, but you are the one who approves it. Step by step:

The agent prepares it

You say “pay the €900 for the contract”. The agent calls releasePayment, but nothing is charged yet.

It gives you a link

The agent hands you an address like trabajosonline.org/confirm-payment/73885f28...

You confirm

You open the link, see the contract and the amount, and press confirm. That is when the money moves.

This is what the agent returns in the first step:

{
  "status": "pending_confirmation",
  "confirmationId": "73885f28ad02648cebf86ff40bfa1f66",
  "confirmUrl": "https://trabajosonline.org/confirm-payment/73885f28...",
  "details": { "contractId": "c-42", "amount": 900 },
  "expiresInSeconds": 900
}

With checkPaymentConfirmation the agent can keep an eye on it: still pending, done, failed, or expired.

Confirming requires signing in on the website. An API key will not do, not even the agent’s own. If the agent could confirm what it asks for itself, this would protect nothing.

Two more safeguards:

The link expires after 15 minutes. Let it lapse and it has to be requested again.
Each link works once. Even if the agent retries, you never pay twice.

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 Integration

What is MCP?

Installation

MCP Server Configuration

Agent-Friendly Pairing (Recommended)

Manual API Key Setup (Alternative)

What you can do

Client

Freelancer

Shared by both

Available Tools

Public Tools (no authentication)

Authenticated Tools (require API key)

The agent never moves your money

Compatible Clients

​MCP Integration

​What is MCP?

​Installation

​MCP Server Configuration

​Agent-Friendly Pairing (Recommended)

​Manual API Key Setup (Alternative)

​What you can do

Client

Freelancer

​Shared by both

​Available Tools

​Public Tools (no authentication)

​Authenticated Tools (require API key)

​The agent never moves your money

​Compatible Clients

MCP Integration

What is MCP?

Installation

MCP Server Configuration

Agent-Friendly Pairing (Recommended)

Manual API Key Setup (Alternative)

What you can do

Shared by both

Available Tools

Public Tools (no authentication)

Authenticated Tools (require API key)

The agent never moves your money

Compatible Clients