# rentseek.ing MCP Server

Remote Model Context Protocol access to rentseek.ing executive compensation data.

## Server

- Endpoint: `https://mcp.rentseek.ing/mcp`
- Transport: Streamable HTTP
- Resource: `https://mcp.rentseek.ing/`
- Documentation: https://rentseek.ing/api/mcp.md

## Authentication

The MCP server accepts exactly one authentication scheme per request. Send OAuth Bearer tokens or `X-API-KEY`, not both.

### OAuth 2.1 + Dynamic Client Registration

Use OAuth for interactive clients that can open the rentseek.ing sign-in and consent flow.

- Issuer: `https://rentseek.ing`
- Protected resource metadata: `https://mcp.rentseek.ing/.well-known/oauth-protected-resource`
- Scope: `executive-compensation:read`
- Dynamic client registration: `https://rentseek.ing/oauth/register`
- Hosted Claude callbacks: `https://claude.ai/api/mcp/auth_callback`, `https://claude.com/api/mcp/auth_callback`

### X-API-KEY

Use API-key authentication for programmatic clients and static bearer-style MCP clients. The same account key works for the REST API and MCP server.

```http
POST https://mcp.rentseek.ing/mcp
X-API-KEY: rsk_live_...
```

Generate keys from https://rentseek.ing/developers.

## Tools

- `get_executive_compensation` (Get Executive Compensation): Get named-executive fiscal-year compensation rows from public company filings. Inputs: `ticker` or `cik`, `period=annual`, `limit` as max fiscal years, and fiscal-year filters such as `fiscal_year_gte`.
- `list_available_tickers` (List Available Tickers): List tickers with published executive compensation data available on rentseek.ing. Inputs: No parameters.

## Claude Code

OAuth setup:

```bash
claude mcp add --transport http rentseek https://mcp.rentseek.ing/mcp
```

API-key setup:

```bash
claude mcp add --transport http rentseek https://mcp.rentseek.ing/mcp \
  --header "X-API-KEY: rsk_live_..."
```

## Claude.ai

Use the custom connector flow with the remote MCP endpoint:

```
https://mcp.rentseek.ing/mcp
```

The OAuth callbacks are allowlisted for `https://claude.ai/api/mcp/auth_callback` and `https://claude.com/api/mcp/auth_callback`.

## Cursor

OAuth setup:

```json
{
  "mcpServers": {
    "rentseek": {
      "url": "https://mcp.rentseek.ing/mcp"
    }
  }
}
```

API-key setup:

```json
{
  "mcpServers": {
    "rentseek": {
      "url": "https://mcp.rentseek.ing/mcp",
      "headers": {
        "X-API-KEY": "${env:RENTSEEK_API_KEY}"
      }
    }
  }
}
```

## Related REST API

- Executive compensation REST docs: https://rentseek.ing/api/executive-compensation.md
- OpenAPI contract: https://rentseek.ing/openapi.json