Skip to main content

Quick Start

Once you have an MCP client connected, you can use Shredly to create MCP servers backed by any HTTP API — no code required. This walkthrough shows a common agent flow end to end.

1. Check your existing servers​

Ask your agent to list what you've already built:

"Can you list the MCP servers I've created on Shredly?"

Me: Can you list the MCP servers I've created on Shredly?

Agent: Let me fetch the schema for the Shredly list tool first.

  Called shredly → listMcpServers()

You don't have any MCP servers created on Shredly yet.

2. Create an MCP server from your API​

Tell the agent about your backend and the tool you want to expose:

"Can you use the Shredly MCP to create an MCP server for my backend? My backend API is at https://api.example.com/. Create one tool called search_products — it makes a POST request to /products/search, accepts a query parameter (string), and the backend authorizes requests using the header X-Api-Key."

The agent will call shredly.createMcpServer with the right shape:

Agent: I'll create that MCP server for you now.

  Called shredly → createMcpServer(
    name: "Example API",
    slug: "example",
    tools: [
      {
        "name": "search_products",
        "description": "Search for products by keyword",
        "method": "POST",
        "url": "https://api.example.com/products/search",
        "headers": {
          "Content-Type": "application/json",
          "X-Api-Key": "{{X_API_KEY}}"
        },
        "input_schema": {
          "query": { "type": "string" }
        },
        "response_transform": ".",
        "timeout_ms": 10000
      }
    ]
  )

Your MCP server "Example API" has been created. Connect to it at:
  https://mcp.shredly.io/mcp/example

Your new MCP server is hosted at https://mcp.shredly.io/mcp/:slug with the tools and configuration you defined.

See MCP Server Schema for more details on how to configure your own server.

3. Use the new server​

Add the new server URL to your MCP client config (see Claude Code, Codex, or Gemini), then start querying it:

"Search my products for 'wireless headphones'."

Agent: Called example → search_products(query: "wireless headphones")

Found 12 results:
  1. Sony WH-1000XM5 — $349
  2. Bose QuietComfort 45 — $279
  ...

Next steps​

  • MCP Server Schema — full reference for tool definitions, auth options, and response transforms.
  • HTTP / SSE setup — connect any HTTP client to your Shredly servers.