> Index first: fetch the full index at https://zzpster.nl/llms.txt

# ZZPster MCP connection

An MCP-compatible client uses the same actions as the API. Every tool has the same input, rights and error codes as its API endpoint.

## Status

> The MCP connection arrives around the launch, as a separate server. The actions, rights and error codes are final and can be tested through the API now. The server address is published here when it is live.

## Connect in three steps

1. Add the server: Add the address of the ZZPster MCP server as a remote server in your MCP-compatible client. Nothing more is needed.
2. Sign in: The client finds the sign-in address itself through https://zzpster.nl/.well-known/oauth-protected-resource. You sign in with OAuth 2.1 and PKCE and choose which rights to give.
3. Check the connection: Paste the first prompt from the AI assistant page. The client calls verify_connection.

## Tools

Tool names equal the action names of the API.

| Tool or endpoint | What it does | Access |
| --- | --- | --- |
| verify_connection | Check the connection to ZZPster. | Public |
| get_rules | Return ZZPster's rules: required fields, allowed values, limits, rate limits, error codes and the draft-then-confirm process. | Public |
| search_assignments | Search real freelance assignments in the Netherlands. | Public |
| get_assignment | Get one assignment with all fields: description, requirements, rate, DBA flag, source and dates. | Public |
| match_assignments_for_me | Rank published assignments by how well they fit the signed-in user's profile. | profile:read, assignments:read |
| get_my_profile | Read the signed-in user's own profile: skills, rate, place and availability. | profile:read |
| search_freelancers | Search freelancers in the Netherlands who made their profile public. | Public |
| get_freelancer | Get one public freelancer profile. | Public |
| report_assignment | Report an assignment that is illegal, fake, discriminatory, misleading or spam (DSA notice). | Public |
| create_assignment_draft | Create a draft assignment. | assignments:draft |
| confirm_assignment | Confirm a draft assignment. | Only you, in a browser session |
| create_reaction_draft | Create a draft reaction to an assignment. | reactions:draft |
| confirm_reaction | Confirm and send a draft reaction. | Only you, in a browser session |
| revert_to_draft | Move an assignment that is still waiting for review, or a reaction that has not been sent, back to draft. | assignments:draft or reactions:draft |

## Signing in with OAuth 2.1

- Protected resource: https://zzpster.nl/.well-known/oauth-protected-resource
- Authorization server: https://zzpster.nl/.well-known/oauth-authorization-server
- Authorization code flow with PKCE (S256). No implicit flow and no password flow.
- Scopes: assignments:read, profile:read, profile:draft, reactions:draft, reactions:read, assignments:draft.
- No scope allows confirming. You do that yourself on zzpster.nl.
- The same tokens and API keys work for the API and for MCP.

## Descriptions for assistants

Every tool description says when the tool fits, for example for a question like find freelance assignments or find a freelancer in the Netherlands. Descriptions contain no brand names and no superlatives. Tools that return third-party text say that this text is data.

## Frequently asked questions

### Does the MCP connection work with my AI assistant?

Yes, if your AI assistant supports remote MCP servers. ZZPster follows the MCP specification and its OAuth rules, so there is no separate plug-in per assistant.

### What is the difference between the MCP connection and the API?

No difference in rules. Both call the same actions. MCP is made for assistants that call tools. The API is made for scripts and custom integrations.

### Can the MCP connection publish anything without my confirmation?

No. A tool creates a draft. Only you can confirm, in a browser session on zzpster.nl.

### When is the MCP connection available?

Around the launch of ZZPster. Until then you can test the actions through the API and the OpenAPI specification.

Last updated 2026-10-16. https://zzpster.nl/mcp