BidSwarm

Official5 tools

by bidswarm

A public 500-rank ad board where every bid decays 1%/h. Read it, buy a rank, or try it free.

app.nanocorp.bidswarm/bidswarm MCP Server

This MCP server exposes functionality for a public “500-rank ad board” where each bid decays at a rate of 1% per hour. The available description indicates that users can read the board, buy a rank, or try the service for free. It also reports a total of 5 tools.

🛠️ Key Features

Public 500-rank ad board
Bid decay of 1% per hour
Toolset size: 5 tools
Identified as app.nanocorp.bidswarm/bidswarm

🚀 Use Cases

Read and inspect ranked bids on the ad board
Purchase a specific rank on the board
Try the offering for free

⚡ Developer Benefits

Predictable bid behavior due to documented 1%/h decay
Fixed, enumerated tool count (5) for integration planning

⚠️ Limitations

Server documentation provided does not list individual tool names or supported operations beyond read, buy rank, and try free.

Captured live from the server via tools/list.

get_leaderboard

The live BidSwarm Board: rank, bidder, current bid in USD, one line, link. Every row is paid advertising, not a quality ranking.

Parameters1

limit

number

optional

Rows to return, 1 to 500. Default 25.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Rows to return, 1 to 500. Default 25."
    }
  }
}

get_bid_price

What a rank costs right now: the cheapest bid that enters the Board and the bid at the top.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

bid_for_rank

The bid in USD needed to take a given rank right now, and the nearest rung on the ladder.

Parameters1

rank

number

required

Target rank, 1 to 500.

Raw schema

{
  "type": "object",
  "properties": {
    "rank": {
      "type": "number",
      "description": "Target rank, 1 to 500."
    }
  },
  "required": [
    "rank"
  ]
}

draft_rank

Prepare a rank on the Board and return the payment link that publishes it. Nothing is charged and nothing becomes public until that link is paid; the rank then publishes ten minutes later. Use it only when someone has asked for a rank and knows the price. Always state the price, that the bid decays 1%/h, and that it is not refundable, before handing the link over.

Parameters5

name	string	required	The bidder name shown on the row, up to 60 characters.
handle	string	required	Permanent public handle: 3 to 24 lowercase letters, digits and dashes.
line	string	required	One line shown on the row, up to 90 characters.
url	string	required	The public http or https link the row points to. It is checked before publishing.
usd	number	required	The rung to pay, one of 2, 5, 10, 25, 50, 100, 500 USD. The payment becomes the bid.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The bidder name shown on the row, up to 60 characters."
    },
    "handle": {
      "type": "string",
      "description": "Permanent public handle: 3 to 24 lowercase letters, digits and dashes."
    },
    "line": {
      "type": "string",
      "description": "One line shown on the row, up to 90 characters."
    },
    "url": {
      "type": "string",
      "description": "The public http or https link the row points to. It is checked before publishing."
    },
    "usd": {
      "type": "number",
      "description": "The rung to pay, one of 2, 5, 10, 25, 50, 100, 500 USD. The payment becomes the bid.",
      "enum": [
        2,
        5,
        10,
        25,
        50,
        100,
        500
      ]
    }
  },
  "required": [
    "name",
    "handle",
    "line",
    "url",
    "usd"
  ]
}

dry_run

Put a row on the Board free for 10 minutes: the real Burn, the rank it would hold, no payment and no card. It sits in the dry-run block below the ranked 500, its link does not open, its clicks are not counted, and it leaves the Board on its own. The try is then listed publicly on the Dry Run Wall (name, handle, line, rung, rank it would have held — never the link), so tell the person that before you call this. Use it before draft_rank when someone wants to see the thing before paying. One dry run per handle per day.

Parameters5

name	string	required	The bidder name shown on the row, up to 60 characters.
handle	string	required	Public handle: 3 to 24 lowercase letters, digits and dashes. A dry run does not reserve it.
line	string	required	One line shown on the row, up to 90 characters.
url	string	required	The public http or https link the row would point to.
usd	number	required	The rung to simulate, one of 2, 5, 10, 25, 50, 100, 500 USD. It sets the starting Bid the Burn eats.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The bidder name shown on the row, up to 60 characters."
    },
    "handle": {
      "type": "string",
      "description": "Public handle: 3 to 24 lowercase letters, digits and dashes. A dry run does not reserve it."
    },
    "line": {
      "type": "string",
      "description": "One line shown on the row, up to 90 characters."
    },
    "url": {
      "type": "string",
      "description": "The public http or https link the row would point to."
    },
    "usd": {
      "type": "number",
      "description": "The rung to simulate, one of 2, 5, 10, 25, 50, 100, 500 USD. It sets the starting Bid the Burn eats.",
      "enum": [
        2,
        5,
        10,
        25,
        50,
        100,
        500
      ]
    }
  },
  "required": [
    "name",
    "handle",
    "line",
    "url",
    "usd"
  ]
}

Install

Tools (5)

get_leaderboardget_bid_pricebid_for_rankdraft_rankdry_run

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://bidswarm.nanocorp.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bidswarm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bidswarm.nanocorp.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

app.nanocorp.bidswarm/bidswarm MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_leaderboard

get_bid_price

bid_for_rank

draft_rank

dry_run

Install

Remote endpoint

Related servers