Model Context Protocol (MCP)

Connect AI agents to at://work

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants like Claude to securely connect to external data sources and tools. MCP allows AI agents to access real-time information and perform actions on your behalf through a standardized interface.

at://work provides an MCP remote server that gives AI agents access to job listings data. This means you can ask your AI assistant questions like "What Rust jobs are available?" or "Show me the latest design positions" and get real-time answers directly from our job board.

What is a Remote MCP Server?

A remote MCP server is an HTTP endpoint that implements the MCP protocol, allowing AI agents to connect over the internet. Unlike local MCP servers that run on your machine, remote servers are hosted services that can be accessed from anywhere.

The at://work MCP server is hosted at: 

https://atwork.place/mcp

This endpoint provides tools for searching and retrieving job listings using the MCP protocol.

Available Tools

The at://work MCP server provides the following tools:

get_listings

Get job listings, optionally filtered by identity or tag.

Parameters:

  • identity (optional) - Filter listings by DID or handle
  • tag (optional) - Filter listings by tag

Example: "Show me all jobs tagged with 'rust'"

get_listing

Get a single job listing by AT-URI or by identity and record key.

Parameters:

  • uri (optional) - AT-URI of the listing
  • identity (optional) - DID or handle of the listing owner
  • rkey (optional) - Record key when used with identity

Example: "Get the job listing at at://did:plc:abc123/place.atwork.listing/xyz789"

search_listings

Search job listings using full-text search.

Parameters:

  • query (required) - Search query string

Example: "Search for senior software engineer positions"

Configuration

To configure the at://work MCP server with Claude Desktop or other MCP-compatible clients, add the following to your MCP configuration file:

Claude Desktop Configuration

Edit your Claude Desktop configuration file:

Add the following to the mcpServers section:

{
  "mcpServers": {
    "atwork": {
      "url": "https://atwork.place/mcp"
    }
  }
}

After saving the configuration, restart Claude Desktop to activate the connection.

Example Usage

Once configured, you can ask Claude questions like:

Claude will use the MCP tools to query the at://work job board and provide you with current, real-time information about available positions.

Authentication

The at://work MCP server uses ATProtocol OAuth for authentication. This means you'll need to sign in with your ATProtocol identity (such as your Bluesky account) to access the MCP tools.

When you first connect to the MCP server, Claude will prompt you to authenticate. This uses the standard OAuth flow with your ATProtocol identity provider, ensuring secure access without sharing your password.

The authentication process follows the ATProtocol OAuth specification, providing:

Privacy & Security

The at://work MCP server provides read-only access to publicly available job listings. Authentication is performed using ATProtocol OAuth, which means your credentials are never shared with the MCP server. Access tokens are cached for performance but automatically expire after 5 minutes.

The server implements the MCP 2025-03-26 protocol specification along with OAuth 2.0 Protected Resource metadata for secure, standardized communication.

Technical Details

For developers and advanced users:

Full protocol documentation is available at the Model Context Protocol website. OAuth Protected Resource metadata follows the RFC 8707 specification.

Learn More