MCP for agents

Give your agent a safe way to manage ServerSearch.

Connect once with Discord, approve the access you want, and let an MCP-compatible agent work with the same content permissions you already have.

Remote MCP endpoint

Streamable HTTP · OAuth 2.1

https://serversearch.xyz/api/mcp

Connect an agentReview connected apps

Connect

A three-step authorization handshake

You do not need to create or copy an API key. ServerSearch handles identity and consent in the browser.

01 Add the endpoint

Choose Add custom MCP server in your client and paste the remote endpoint above.

02 Sign in and approve

Your browser opens ServerSearch. Sign in with Discord and review the requested scopes.

03 Ask your agent

The client discovers the available tools and can act only within the permissions you approved.

Client setup

Use the URL directly or add it to your client config.

Clients with an MCP settings screen only need the endpoint. If your client uses a JSON configuration file, the common shape looks like this. Exact configuration names can vary by client.

{
  "mcpServers": {
    "serversearch": {
      "url": "https://serversearch.xyz/api/mcp"
    }
  }
}

Available tools

Content management without destructive access

Your agent sees a focused set of profile, organization, community, server, and image tools.

Profile

  • get_my_profile
  • update_my_profile

Organizations

  • list_my_organizations
  • get_organization
  • update_organization

Communities

  • list_my_communities
  • get_community
  • create_community
  • update_community
  • set_community_status

Servers

  • list_community_servers
  • get_server
  • create_server
  • update_server
  • set_server_status

Images

  • create_image_upload
  • get_image_upload

Scopes

Approve only what the agent needs

serversearch:read

View your profile and the content you can manage.

serversearch:content.write

Create and update organizations, communities, and servers.

serversearch:media.write

Prepare and inspect owned image uploads.

offline_access

Optional. Let the client refresh access when you are away.

Safety boundary

Some account controls are intentionally unavailable

MCP cannot hard-delete content or manage:

  • Account authentication
  • Organization members
  • Roles and permissions
  • Ownership transfers
  • Billing
  • Featured placement
  • Platform administration
  • Server diagnostics

Draft, published, and archived statuses are reversible. You can revoke an agent at any time from Connected applications.

Try asking

Start with a reviewable task

For important edits, ask the agent to show its proposed changes before it applies them.

“Show me the communities I can manage and summarize what needs attention.”
“Update my community description, but show me the proposed copy first.”
“Create a draft Minecraft server in my Aftermath Gaming community.”
“Archive this server listing without deleting it.”

Troubleshooting

Authorization expired

Start the connection again from your MCP client. Do not reload an old OAuth callback URL.

A tool is missing

Reconnect and approve the required read, content, or media scope when prompted.

Access was revoked

Remove the stale connection from your client, then add the ServerSearch endpoint again.