@trabajos-online/mcp-client

MCP (Model Context Protocol) Client for Trabajos Online. Connect your AI tools to Trabajos Online's freelance platform — search freelancers, post jobs, manage contracts, and pay with crypto or Stripe.

What is This?

This package allows you to use Trabajos Online with:

• Claude Desktop - Anthropic's Claude AI
• Claude Code - CLI with MCP server support
• Cursor - AI-powered code editor
• Windsurf - AI-powered IDE
• n8n - Workflow automation
• Any other MCP-compatible tool

Quick Start

1. Add MCP Server Config

No API key needed upfront — use agent-friendly pairing to authenticate.

Claude Desktop (claude_desktop_config.json):

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

Cursor (.cursor/mcp.json):

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

n8n: Go to Credentials → Add MCP Server, set command to npx and arguments to @trabajos-online/mcp-client.

2. Authenticate

Agent-Friendly Pairing (Recommended)

The easiest way — no manual key copying needed:

1. Agent calls getPairingCode — gets a code like TRB-A3B7
2. Agent tells you: "Enter this code at trabajosonline.org/settings"
3. You enter the code in Settings → API Keys → Enter Pairing Code
4. Agent calls checkPairingStatus — API key is auto-configured

Manual API Key (Alternative)

1. Sign up at trabajosonline.org
2. Go to Settings → API Keys and generate a key
3. Add it to your MCP config:

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

Available Tools

Public Tools (no authentication required)

| Tool | Description | |------|-------------| | getPairingCode | Generate a pairing code for agent-friendly authentication | | checkPairingStatus | Check if a pairing code has been confirmed | | searchJobs | Search for jobs by query, category, budget | | getUserProfile | Get user profile (by email, wallet, or "current") | | getJobApplications | Get proposals for a specific job | | getContract | Get contract details by ID | | getConversation | Get messages in a conversation | | listCategories | List all available job categories |

Authenticated Tools (require API key or pairing)

| 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 | | releasePayment | Release payment to a freelancer | | getPaymentStatus | Check payment status for a contract |

Example Usage

You: "Find me a React developer under $50/hr"
AI: [Calls searchJobs] "I found 7 freelancers..."

You: "Post a job for a logo designer with a $500 budget"
AI: [Calls postJob] "Done! Job posted successfully."

You: "Show me my active contracts"
AI: [Calls listActiveContracts] "You have 3 active contracts..."

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | TRABAJOS_API_KEY | No | Your API key (use pairing instead) | | TRABAJOS_MCP_URL | No | Custom MCP server URL (defaults to production) |

Troubleshooting

"Only pairing and read-only tools will work"

This is normal if you haven't set an API key. Use getPairingCode to pair with your account, or set TRABAJOS_API_KEY in your config.

"MCP Server error: 401 Unauthorized"

Your API key is invalid or expired. Generate a new one from Settings → API Keys, or use pairing.

"Pairing code not found or expired"

Pairing codes expire after 10 minutes. Call getPairingCode again to generate a new one.

Links

• Trabajos Online
• API Documentation
• MCP Setup Guide
• npm
• MCP Protocol Spec

License

MIT