MCP Server

1 Edit Claude Configuration

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "geocoder-cloud": {
      "url": "https://mcp.geocodercloud.com/mcp",
      "headers": {
        "X-API-KEY": "gck_your_api_key_here"
      }
    }
  }
}

2 Restart Claude Desktop

Completely close and reopen Claude Desktop to load the MCP server.

1 Edit MCP Configuration File

Open or create ~/.cursor/mcp.json and add:

{
  "mcpServers": {
    "geocoder-cloud": {
      "url": "https://mcp.geocodercloud.com/mcp",
      "headers": {
        "X-API-KEY": "gck_your_api_key_here"
      }
    }
  }
}

2 Restart Cursor

Completely close and reopen Cursor IDE to load the new MCP server.

3 Verify Connection

Check Cursor's MCP logs to verify the connection:

1 Using with OpenAI API / GPTs

Configure the Geocoding API as an external tool in your OpenAI application:

{
  "type": "function",
  "function": {
    "name": "geocode_address",
    "description": "Geocode a US address to coordinates",
    "parameters": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "description": "The US address to geocode"
        },
        "limit": {
          "type": "integer",
          "description": "Max results (1-10)",
          "default": 5
        }
      },
      "required": ["address"]
    }
  },
  "api": {
    "url": "https://mcp.geocodercloud.com/api/geocode",
    "method": "GET",
    "headers": {
      "X-API-Key": "gck_your_api_key_here"
    },
    "query_params": {
      "address": "{address}",
      "limit": "{limit}"
    }
  }
}

2 Using with Custom GPTs

Create a Custom GPT and add these actions:

• Action 1: Geocode Address
  • Method: GET
  • URL: https://mcp.geocodercloud.com/api/geocode
  • Params: ?address={address}&limit={limit}
• Action 2: Standardize Address
  • Method: GET
  • URL: https://mcp.geocodercloud.com/api/standardize
  • Params: ?address={address}

3 Authentication Setup

Configure authentication for your Custom GPT:

• Authentication Type: API Key
• Auth Type: Custom
• Header Name: X-API-Key
• API Key: gck_your_api_key_here

4 Using with OpenAI Assistants API

Add as a function in your Assistant:

import openai

# Create assistant with geocoding tool
assistant = openai.beta.assistants.create(
    name="Geocoding Assistant",
    instructions="You are a helpful assistant that can geocode addresses.",
    model="gpt-4-turbo-preview",
    tools=[{
        "type": "function",
        "function": {
            "name": "geocode_address",
            "description": "Geocode a US address to get coordinates",
            "parameters": {
                "type": "object",
                "properties": {
                    "address": {"type": "string"},
                    "limit": {"type": "integer", "default": 5}
                },
                "required": ["address"]
            }
        }
    }]
)

# In your tool call handler:
import requests

def handle_geocode(address, limit=5):
    response = requests.get(
        "https://mcp.geocodercloud.com/api/geocode",
        headers={"X-API-Key": "gck_your_api_key_here"},
        params={"address": address, "limit": limit}
    )
    return response.json()