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"
        }
      },
      "required": ["address"]
    }
  },
  "api": {
    "url": "https://www.geocodercloud.com/api/v1/geocode",
    "method": "POST",
    "headers": {
      "X-API-Key": "gck_your_api_key_here"
    },
    "json_body": {
      "address": "{address}"
    }
  }
}

2 Using with Custom GPTs

Create a Custom GPT and add this action:

• Geocode Address
  • Method: POST
  • URL: https://www.geocodercloud.com/api/v1/geocode
  • JSON body: {"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"}
                },
                "required": ["address"]
            }
        }
    }]
)

# In your tool call handler:
import requests

def handle_geocode(address):
    response = requests.post(
        "https://www.geocodercloud.com/api/v1/geocode",
        headers={"X-API-Key": "gck_your_api_key_here"},
        json={"address": address}
    )
    return response.json()