Connecting Other MCP Clients

Promptsy works with any MCP-compatible AI assistant. This guide covers generic setup for clients not specifically documented.

Server Information

Use these details to configure any MCP client:

Property	Value
Server URL	https://mcp.promptsy.dev/mcp
Transport	HTTP (Streamable HTTP)
Authorization	OAuth 2.1

OAuth 2.1 Endpoints

For clients that require explicit OAuth configuration:

Endpoint	URL
Authorization	https://mcp.promptsy.dev/authorize
Token	https://mcp.promptsy.dev/oauth/token
Callback	Configured in your client

Scopes

Request these scopes based on your needs:

Scope	Permission
prompts:read	View prompts and collections
prompts:write	Create and save prompts
account:read	View tier and credit balance

All scopes are recommended for full functionality.

Well-Known Endpoints

Promptsy exposes standard discovery endpoints:

https://mcp.promptsy.dev/.well-known/mcp-server-info
https://mcp.promptsy.dev/.well-known/oauth-protected-resource

Available Tools

Once connected, these tools become available:

browse_prompts

Browse your personal prompt library.

Parameters:

• limit (optional): Number of prompts (1-50, default 20)
• offset (optional): Pagination offset (default 0)

Requires: prompts:read scope

save_prompt

Save a new prompt to your vault.

Parameters:

• title (required): Prompt title
• body (required): Prompt content
• description (optional): Brief description
• category (optional): Prompt category
• models (optional): Array of AI models
• use_cases (optional): Array of use cases
• tag_names (optional): Array of tags

Requires: prompts:write scope

search_public_prompts

Search the public prompt community.

Parameters:

• query (optional): Search query
• category (optional): Filter by category
• sort (optional): trending, recent, popular, relevance
• limit (optional): Number of results (1-50, default 20)
• offset (optional): Pagination offset

Requires: No authentication

Health Check

Verify the server is running:

curl https://mcp.promptsy.dev/

Expected response:

{
  "status": "ok",
  "service": "promptsy-mcp-server",
  "version": "1.0.0"
}

Testing Connection

Before integrating, test the OAuth flow:

1. Open in browser: https://mcp.promptsy.dev/authorize?client_id=test&redirect_uri=https://example.com&response_type=code&scope=prompts:read
2. Authorize when prompted
3. Check that you're redirected with an auth code

Example: Custom Integration

Here's a minimal example of connecting to the MCP server:

// After OAuth, you'll have an access token
const accessToken = 'your-access-token';

// Connect to the MCP endpoint
const response = await fetch('https://mcp.promptsy.dev/mcp', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/list',
    id: 1
  })
});

const data = await response.json();
console.log('Available tools:', data);

CORS Support

The MCP server allows cross-origin requests:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS, DELETE
Access-Control-Allow-Headers: Content-Type, Authorization, mcp-session-id

Rate Limits

To ensure fair usage:

• Authenticated requests: 100/minute per user
• Public search: 30/minute per IP

Rate limit headers are included in responses:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Troubleshooting

Connection refused

1. Check the URL is correct: https://mcp.promptsy.dev
2. Verify your network allows outbound HTTPS

Invalid token

1. Tokens expire after 1 hour
2. Use the refresh token to get a new access token
3. If refresh fails, re-authorize

Tool not found

1. Verify you're using the correct tool names
2. Check the tools list at the server info endpoint

Next Steps

• Authentication Details
• Security & Privacy
• Tool Reference