Model Context Protocol

Connect your MCP client

Wire Claude Desktop, Claude Code, ChatGPT, Cursor, or Windsurf to live job and salary data over Model Context Protocol. No API key. Two minutes.

No API keyUnauthenticated~2 min setupStreamable HTTP

MCP Server URL

Same URL for every client. Streamable HTTP. No auth headers, no tokens, no allowlist.

url

https://agentic-engineering-jobs.com/api/mcp

Tools loaded:search_jobsget_jobget_salaries

Claude Desktop

UI steps

Use the Custom Connectors UI. No config file edit needed on recent Claude Desktop builds (Free, Pro, Max, Team, Enterprise).

text

1. Open Claude Desktop, then Settings (gear icon), then Connectors.
2. Click "Add custom connector".
3. Paste this URL: https://agentic-engineering-jobs.com/api/mcp
4. Leave the OAuth fields empty. The server is public and unauthenticated.
5. Click Add. Restart Claude Desktop.
6. Open a new chat. The tool drawer should list search_jobs, get_job, get_salaries.

Verify: Restart Claude Desktop. Open a new chat and click the tool drawer. search_jobs, get_job, and get_salaries should appear.

Claude Code

One CLI command

One CLI command. Writes to ~/.claude.json by default. Add --scope project to share via .mcp.json, or --scope user for cross-project availability.

bash

claude mcp add --transport http agentic-jobs https://agentic-engineering-jobs.com/api/mcp

Verify: Run claude mcp list. agentic-jobs should appear with status connected. Inside Claude Code, type /mcp to confirm tools are loaded.

ChatGPT

UI steps

Available on Pro, Business, Enterprise, and Education plans. Free and Plus tiers cannot add custom MCP servers. Developer Mode must be on.

text

1. ChatGPT, then Settings, then Connectors, then Advanced, then toggle Developer Mode ON.
2. Settings, then Connectors, then Add new connector.
3. Name: Agentic Engineering Jobs
4. MCP Server URL: https://agentic-engineering-jobs.com/api/mcp
5. Authentication: None
6. Click Create. ChatGPT validates the connection and lists tools.
7. New chat. Click +, then select Agentic Engineering Jobs to enable it.

Verify: Open a new chat. Click the + menu. Select Agentic Engineering Jobs to enable the connector. Tools load on first use.

Cursor

JSON config

Project-scoped via .cursor/mcp.json or global via ~/.cursor/mcp.json. Bare { url } shape, no type field.

json

{
  "mcpServers": {
    "agentic-jobs": {
      "url": "https://agentic-engineering-jobs.com/api/mcp"
    }
  }
}

Verify: Cursor Settings, then Tools & MCP. agentic-jobs should show 3 tools (search_jobs, get_job, get_salaries) with green status.

Windsurf

JSON config

Edit ~/.codeium/windsurf/mcp_config.json. Windsurf uses the serverUrl key, not url. Easy to mix up if you copied the Cursor snippet.

json

{
  "mcpServers": {
    "agentic-jobs": {
      "serverUrl": "https://agentic-engineering-jobs.com/api/mcp"
    }
  }
}

Verify: Open Cascade. Click the MCP server icon. agentic-jobs should appear with the three tools listed.

Stuck?

Troubleshooting

My tool drawer is empty after I add the server.

Restart the client. Most clients only load the tool list on startup. If tools still do not appear, check the client's MCP status panel for a connection error and confirm the URL is exactly https://agentic-engineering-jobs.com/api/mcp (with the /api prefix).

ChatGPT does not show "Add new connector" in Settings.

You need Pro, Business, Enterprise, or Education tier and Developer Mode toggled on. Settings, then Connectors, then Advanced, then Developer Mode. Free and Plus tiers cannot add custom MCP servers.

Cursor or Windsurf saved the config but tools never appear.

Check the JSON key. Cursor uses url. Windsurf uses serverUrl. Pasting one snippet into the other client fails silently because the client ignores the unknown key. Restart the editor after editing the config.

Claude Code rejects the mcp add command.

Argument order is strict: claude mcp add --transport http <name> <url>. Flags before name, name before url. The CLI breaks REST-style URL-first conventions.

My client is older and does not support remote MCP natively.

Wrap with the mcp-remote bridge: npx -y mcp-remote@0.1.38 https://agentic-engineering-jobs.com/api/mcp. This was needed historically before clients shipped Streamable HTTP. As of April 2026 every client listed above supports native HTTP, so the bridge is only relevant for stale installs.

How do I report a problem?

Email hello@maxim-buz.dev or open an issue at https://github.com/MaximBuz/agentic-engineering-jobs.

Prefer REST?

Browse the public API reference

curl examples, filters, error codes, and an interactive playground.

/api-reference